Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ctrlnode.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
Bridge setup and pairing tokens

​
Bridge status

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

​
Pairing tokens

  1. Click New Token
  2. Copy the token when shown — it will not be displayed again
  3. Revoke old tokens you no longer use
Regenerate from /setup/token during onboarding if needed.

​
Install

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.

​
Run

PAIRING_TOKEN=<your-token> ./ctrlnode-bridge
Or run ./ctrlnode-bridge and use the interactive wizard.
Open source Bridge: github.com/ctrlnode-ai/ctrlnode

​
Troubleshooting

IssueCheck
Stays disconnectedToken copied correctly; Bridge process running
Auth errorsNo duplicate PAIRING_TOKEN= in .env; shell env not overriding file
Agents missingBridge connected; agent registered in Team
Previous: Events · Quickstart