All docs pages ↓
Troubleshooting
Find the symptom, then the next step. Each next step links to the page that explains it.
| Symptom | Next step |
|---|---|
| No hosts configured | Add a hosts file, or allow this machine with --host SYSTEM=localhost. See Name the machines. |
| Dirty checkout refused | Commit your changes, or run a snapshot of the working tree with --no-strict. See Run uncommitted changes. |
| Web service already running | Open its URL, or replace it with odu web --upgrade. |
| A proxied page is refused as cross-origin | Start or replace the service with ODU_WEB_ALLOWED_ORIGINS set to the browser’s origin. See Access through Tailscale or a proxy. |
serves the <row> row at …: the service and your build disagree |
That part of the service moved a major version. Run odu web --upgrade, or use a build that reads that version. See Contract versions. |
| Retry refused | Read the reason. Check the snapshot, the record of where the run ran, and whether the checkout is still there. |
| CI passed but GitHub is waiting | Check what the run still owes GitHub (odu ci status), and the service’s gh credentials. |
| A node is red but its recipe passed | Its push failed. See When a push fails. |