Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Find the failing stage and recover from common setup, deployment, and runtime problems.
| Symptom | Check | Next action |
|---|---|---|
| Compose does not start | Required .env values and migration logs | Run docker compose config --quiet, then inspect migrate and api logs |
| Login works locally but fails behind a proxy | App/API origins and trusted proxy hops | Check public origins and rebuild browser assets after changing URLs |
| Repository missing | GitHub App installation access | Grant access to the repository and approve required permissions |
| Repository sync fails | Manifest error and referenced server IPs | Fix the reported field or register the server, then sync again |
| Server Setup Pending | SSH trust and preparation result | Verify the host fingerprint, then complete server preparation |
| Symptom | Check | Next action |
|---|---|---|
| Push did not deploy | Webhook delivery, sync result, auto-deploy policy, input patterns, pause state | Fix the first failed stage; use a manual deployment to isolate automation |
| Work remains queued | Active server work and concurrency | Inspect the current operation before increasing concurrency |
| Build fails | Dockerfile, context, build-stage secrets, host disk | Correct the failing command and retry |
| Candidate fails health | Port, listen address, path, startup timeout, runtime secrets | Make the endpoint reachable from the container network |
| Domain fails after build | DNS, inbound ports, Caddy, TLS configuration | Follow Domains and TLS |
| Pre-deploy hook fails | Hook logs and stage secrets | Resolve the command failure; promotion has not completed |
| New secrets are not in use | Save result and subsequent deployment | Deploy after saving; save does not restart the container |
