Installing the rig agent

Each rig PC runs a small Python service that talks to PitwallOS over HTTPS. The agent loads circuits, vehicles, and sessions on cue from the admin UI; it never opens an inbound port.

1. Download the installer

From your admin console, navigate to Settings → Rigs & agents and click Download installer. You get a signed Windows executable; current size is ~25 MB.

The installer registers the agent as a Windows service so it starts on boot. No console window stays open.

2. Generate a setup token

On the same settings page, click Generate setup token. The token is one-shot: paste it into the agent on first launch and it auto-binds to a specific rig in your venue. Anyone with the token can register a rig, so don't share it; tokens expire after 24 hours.

3. Run the installer on the rig PC

Double-click PitwallOSAgentSetup.exe. The installer prompts for the setup token; paste it and click Bind. The agent verifies the token, exchanges it for a long-lived rig token (stored encrypted via Windows DPAPI), and registers itself as the PitwallOSAgent service.

4. Confirm the heartbeat

Back in the admin console, the rig appears with a green dot within ~10 seconds of binding. If the dot stays grey or red, check the troubleshooting guide.

5. Approve the rig

New rigs land in pending approval until an admin clicks Approve. This prevents an attacker from plugging in a rogue PC and consuming bookings.