Diagnose a Server
Start at the failed boundary, collect secret-free evidence, and repair only after the instance and failure mode are known.
Do not manufacture a second instance because the first one is confusing. Identify the profile, topology, setup state, and failed boundary before you mutate anything.
Read-only first pass
nautilo profile current
nautilo status --format=json
nautilo logs --service nautilo-serverFor a remote Compose profile, add:
nautilo doctor remote circle-serverstatus reports Compose state plus best-effort HTTP/setup health. It is not a
full runtime-acceptance declaration. Logs work through local or remote Compose
even though the current help text still says “local-compose.” Review output for
secrets before sharing it.
Symptom → check → repair
| Symptom | Check | Repair boundary |
|---|---|---|
| Wrong Server or unexpected data | nautilo profile current; compare instance ID and endpoint | Select the intended profile. Do not redeploy yet |
| Containers run but login is dead | nautilo status; inspect setup state and auth-service logs | Recover identity/setup state; do not create another owner blindly |
| Remote command cannot connect | nautilo doctor remote <profile> | Repair DNS, SSH trust, path ownership, Docker, or transfer tooling at its authority |
| UI loads but a Genie cannot answer | Prove the selected provider and one model-backed turn | Repair provider configuration or capability routing; container health is insufficient |
| Upgrade applied but behavior is old | Compare immutable image identity and /health deployment identity | Publish/select the intended immutable artifact, then run guarded upgrade |
| Restore or upgrade failed | Preserve the exact bundle and command output | Verify the bundle before any second mutation; follow the recovery branch |
What success means
Acceptance is the intended instance, ready setup state, owner sign-in, SPA delivery, and a real model-backed turn. Guarded upgrade performs runtime acceptance. Direct restore health-polls the restarted Server, so the operator must run that complete acceptance pass afterward rather than trusting health alone.