Troubleshooting
Common errors and fixes
Reference table of AEON platform error codes and CLI failures with the exact remedy for each, from auth problems to quota and lane errors.
5 min read
| Error | Cause | Fix |
|---|---|---|
| AEON-401 invalid token | Expired or revoked token | aeon login, or rotate the machine token |
| AEON-403 scope missing | Token lacks exec:run | Recreate the token with the scope |
| AEON-409 lane busy | All matching lanes reserved | Drop --sdr / --region constraints |
| AEON-422 pics mismatch | PICS contradicts the suite | aeon config lint |
| AEON-429 rate limited | Too many API calls | Honour Retry-After; batch calls |
| AEON-503 lane degraded | Mid-run hardware fault | Run is re-queued automatically; no charge |
| build entrypoint not found | Wrong --entrypoint | aeon builds show to inspect the archive tree |
| verdict inconc, jitter exceeded | Tunnel latency budget blown | Switch to hosted build model |
Getting help with context
bashbash
aeon support bundle --exec 4821 --out ./bundle.tar.gz # redacted logs + config + lane metadata, safe to attach to a ticket
Run this against a real SDR lane
The tester is a service, not a box. Push a build, reserve a lane, get a verdict.