Reference

Troubleshooting

Quick first checks for common symptoms.

Troubleshooting quick hits

Symptom	First check
Turns refuse with a budget message	Analytics → raise budget or disable ENFORCE
Turns refuse with a license message	`aios license status`; renew or (owner) remove the marker
Gateway silent on Telegram	`journalctl -u aios-gateway`; token in `.env`; allowlist `TELEGRAM_ALLOWED_USER`
Wrong/odd cached answers	Analytics → clear cache; raise `semantic_threshold` in harness.json
Project answers ignore documents	⛁ Projects → Reindex; confirm the project selector/`--project` is set
Subdomain 403/404	project domain assignment re-run; `nginx -t`; cert exists for apex
Disk filling	`cargo clean` (dev boxes), `journalctl --vacuum-size=100M`, prune `/var/backups/aios`
Site “unreachable” / `ERR_NAME_NOT_RESOLVED` right after enabling Tailscale	Not a server issue — see Remote access; add Global Nameservers to your tailnet or use `--accept-dns=false`