Troubleshooting
Common NOME Build Cloud issues and fixes — runner offline, cache miss, signature failures, blocked deploys, missing webhooks, CodeRabbit not detected.
Runner offline
NOME shows the runner but greys out Run. Confirm the machine is awake and the agent is running; for an owner-edge box behind NAT, confirm Tailscale or SSH reachability. Under a service supervisor, check the unit status and logs.
Cache miss / slow build
If incremental builds are slow, the warm cache may not be hitting. Confirm the runner is reaching the project-isolated cache store, that cache keys aren't being invalidated by a noisy input (for example a timestamp baked into a layer), and that you aren't forcing a clean build. See BuildKit cache.
Signature verification failed
A deploy blocked on signature verification means the artifact is unsigned, the signature is broken, or provenance is unverifiable. NOME fails closed here on purpose. Re-run the sign stage and confirm the artifact came from the pipeline that signed it. See Artifact signing.
Deploy blocked at the gate
A blocked deploy means a gate condition isn't satisfied — tests not green, review signals unresolved, artifact not verifiable, branch protection not met, or a missing human approval. NOME reports which condition blocked and never fakes a green. Resolve the named condition and re-run the gate.
Webhook didn't arrive
CodeRabbit status not detected
If a CodeRabbit signal isn't showing in the gate, confirm CodeRabbit is installed on the repository and has actually posted a review, and that the same repository is connected to NOME so it can read the status. CodeRabbit is optional — the rest of the pipeline runs whether or not it is connected. See CodeRabbit.
Ready to try it?
Open NOME