Bridge Setup

Route

/system/bridge-tokens

Breadcrumb: SYSTEM → BRIDGE SETUP

This is the most important step. Without a connected Bridge, agents do not appear in Team and tasks are not dispatched.

Green dot = Connected (shows active agent count). Red = Disconnected — verify the Bridge process is running with a valid token.

Regenerate from /setup/token during onboarding if needed.

Windows (PowerShell):

iwr https://github.com/ctrlnode-ai/ctrlnode/releases/latest/download/install.ps1 | iex

Linux / macOS:

curl -fsSL https://github.com/ctrlnode-ai/ctrlnode/releases/latest/download/install.sh | bash

Installers write ~/.ctrlnode/.env with PAIRING_TOKEN and workspace paths.

$env:PAIRING_TOKEN="<your-token>"
ctrlnode

PAIRING_TOKEN=<your-token> ctrlnode

Installers write ~/.ctrlnode/.env with PAIRING_TOKEN, SAAS_URL, and BASE_PATH (workspace parent). See Install.

Issue	Check
Stays disconnected	Token copied correctly; Bridge process running
Auth errors	No duplicate `PAIRING_TOKEN=` in `.env`; shell env not overriding file
Agents missing	Bridge connected; agent registered in Team