Docs/NOME Build Cloud/Owner-edge runner

Owner-edge runner

Register a machine you own — Mac, Linux, home server, or your own VM — as a NOME Build Cloud runner.

What an owner-edge runner is

An owner-edge runner is a machine you own and operate that NOME dispatches build, test, and (when scoped) deploy jobs to. It runs your toolchain on your network. NOME provides scheduling, cache, review, and the gate; you provide the hardware. Owner-edge runs consume no NOME compute credits.

Install and pair

Install the NOME runner on the machine, then pair it to your account: the machine mints a one-time pairing token, you claim it from a signed-in NOME client, and you confirm on the machine. A host-scoped device token authorizes that one machine as a runner — it is not your account password and carries no provider credentials.

Run as a service

To keep an owner-edge runner available across reboots, run the agent under a process supervisor (for example systemd on Linux) with a restart-on-failure policy. Inspect health and logs to confirm it is online. For a machine behind NAT, reach it over a private network (Tailscale) or SSH.

Protected and ephemeral

Build and test jobs run in ephemeral workspaces that are cleaned up at the end of the job, with cache restored from the project-isolated store. Deploy-scoped runners are protected and tagged separately so a build/test runner can never run a deploy. See Security.

NOME cloud runners

When you would rather not operate a machine, select a NOME cloud runner: managed, isolated per job, torn down when the job ends. Cloud runners bill in NOME credits; owner-edge runners do not. You can mix both — owner-edge for routine builds, cloud for burst.

Ready to try it?

Open NOME