Troubleshooting

"Running workers requires Deno" / a worker won't start. Install Deno so the deno binary is on PATH, or set NANOBPMN_DENO_BIN to its full path, then reload the Workers tab. You can author and export workers without Deno; only running them needs it.

Everything was lost after a restart. The server runs in-memory unless you set NANOBPMN_DATA_DIR (or use c8ctl nano, which configures persistence for you). Point it at a stable directory to keep data across restarts.

A query doesn't show a write I just made. Reads are eventually consistent (typically sub-millisecond lag). Re-query, or use awaitCompletion / awaitInstance when you need to act on a terminal result.

Work is stuck and an instance "has an incident". A job ran out of retries or a gateway/error failed. Inspect it in the Explorer tab or via POST /v2/incidents/search, fix the cause (give retries with PATCH /v2/jobs/{key} or correct variables), then resolve it with POST /v2/incidents/{incidentKey}/resolution to retry the failed work.

Can't reach the console at localhost:8080. Check the URLs printed at startup — you may have set a different PORT, or another process may hold the port. In a cluster, use c8ctl nano status to see each node's health.