fbuildConnecting a machine
Agents run on your own machines through a small program called the runner. Once it's online, that machine's projects become available for tasks.
Agents in fbuild run on your own machines, not in the cloud. A small program called the runner connects a machine to your workspace so agents can work there.
Connect a machine #
- In the console, go to Soldiers and choose to add a machine — this mints a one-time enrollment token and shows you a command.
- Run that command on the machine you want to connect. The runner installs, enrolls with your workspace, and comes online.
- The machine now appears in Soldiers as online, and its repositories become selectable projects when you create a task.
Good to know #
- One machine, many workspaces. The same computer can join several workspaces without conflicts.
- It stays connected. The runner reconnects on its own after a network blip or a sleep/wake.
- Your repos stay yours. The runner only exposes projects you've granted — it does not scan your whole machine.
- Terminals persist. A terminal you open for a project re-attaches to the same live shell when you come back.
Once a machine is online, head to Creating & running a task.