5.2Enrolling a runner

1. 1

   Open Builds in the dashboard

   The Runners panel lists every machine enrolled in your organization and whether it is online.

2. 2

   Add a build runner

   Give the machine a name you will recognize — studio-build-01 beats runner 2 the day you need to walk over and look at one. You get an enrollment token starting with forge_, shown exactly once.

3. 3

   Install USourceControl Forge

   Download it from the same panel and install it on the build machine.

4. 4

   Paste the token

   The runner enrolls, heartbeats every few seconds, and reports which platforms it can actually target.

That last part matters more than it looks. Because a runner reports its real capabilities, the pipeline form will not offer you a platform whose build would fail an hour into the queue — you find out that nobody can build for Linux when you are configuring it, not when you are waiting for it.

Running it in the background

Like the desktop app, Forge closes to the tray rather than quitting, and can start with the system straight into the tray. A build machine that reboots for updates comes back building instead of waiting for someone to notice.