Every run exits with one of the codes below. Nonzero exits print a description of the failure to stderr.
| Code | Meaning |
|---|---|
| 0 | Success. Informational flags such as --help and --version also exit 0. |
| 1 | Unknown or internal error not covered by a more specific code. |
| 2 | The render exceeded its process timeout. |
| 3 | Invalid arguments, including flags that require a higher license tier. |
| 4 | Interrupted by SIGINT or SIGTERM. |
| 5 | Environment setup failed: CEF startup, display, proxy configuration, license validation, or loading a blocklist or adblock list. |
| 6 | The page rendered but encoding the output failed. |
| 7 | The page failed to load. |
| 8 | Access disallowed by the site’s robots.txt. |
| 9 | LLM navigation with --navigate did not achieve its goal. |
| 10 | An internal event queue was full and the request could not be dispatched. |
| 11 | The primary output was written, but a HAR, WARC, or network-log output failed to write. |
| 12 | The render succeeded but streaming the payload to stdout with -f - failed. |
In --server mode these codes apply to server startup; failures of
individual render requests are reported in the HTTP response instead.