Troubleshooting¶

Symptom	Page
SSH / key / deps / docker group	SSH, rsync & dependencies
Backup failed / stuck pending	Backups
No push on phone / PWA	Push / PWA
Template deploy / Docker editor	Templates & Docker
Reboot hangs / UI stuck after reboot	Updates — Reboot
Same patch job appears twice	Jobs — Exclusive jobs · Multi-worker
Full editor link does nothing	Compose edit — use ⋯ Full editor…
Fleet Services empty	Dashboard & Services — bind Kuma monitors
Network map hosts not linked / cloud wrong	Network maps — set LAN/gateway/public IP; hard-refresh after rebuild
Layout stuck after phone rotate (esp. Network)	Hard-reload once after deploy; maps should reflow without leaving the page (Appearance)
Dashboard NPM hosts ≠ NPM proxy count	Dashboard uses poll `proxy_host_count`; poll NPM integration if stale
Cert deploy / renew failed	Certificates · Jobs + Audit
Drift after host edit	Deploy — Check drift
Stack unhealthy after upgrade	Status · Upgrades
Cannot open Settings tabs / herder restore	Roles — control plane is admin only
First boot asks to register / no default password	Expected — First login

Always useful¶

docker compose ps
docker compose logs web --tail=200
docker compose logs celery-worker --tail=200

Jobs page for work unit status + log tail
Audit for who/what / client IP
Settings → Status for stack health (Settings)
Server SSH access → Check dependencies (or Test connection) for remote tools
Scenario index: Operator scenarios