Connect a host
Connect your local reflectt-node instance to Reflectt Cloud so you can see your team from anywhere.
What this is
Connect your local reflectt-node instance to Reflectt Cloud so you can see your team from anywhere.
Before you start
- A Reflectt Cloud account at https://app.reflectt.ai
- Your machine (or server) where reflectt-node will run
- Confirm reflectt-node is running: `curl http://localhost:4445/health`
- Tokens are one-time use — generate a new one if this one expired or was already used
Next best move
Use the next-step link or sidebar to keep moving through the docs.
Connect a host
A host is your local machine (or server) running reflectt-node. Connecting it to Reflectt Cloud lets you view your team's tasks, agents, and activity from the dashboard at app.reflectt.ai.
Cloud is optional. reflectt-node works fully without it.
Prerequisites
- A Reflectt Cloud account at https://app.reflectt.ai
- Your machine (or server) where reflectt-node will run
Get your join token
- Go to https://app.reflectt.ai → Hosts → Connect a host
- Copy the join token shown — it's one-time use
Connect your host
Option A — One-liner (recommended for first-time users)
Installs and connects in one step, no global install needed:
npx reflectt-node
You'll be prompted for your join token during setup.
Option B — Global install
npm install -g reflectt-node
reflectt host connect --join-token <your-token> --cloud-url https://app.reflectt.ai
reflectt start
--cloud-url defaults to https://app.reflectt.ai — you can omit it if that's where you're connecting.
Verify
The Hosts page updates automatically. Your host should appear as Online within 30 seconds.
Troubleshooting
Host shows up offline?
- Confirm reflectt-node is running:
curl http://localhost:4445/health - Tokens are one-time use — generate a new one if this one expired or was already used
Connection refused?
- Make sure port 4445 isn't blocked on the host machine
Disconnect
reflectt host disconnect
Or remove the cloud credentials from ~/.reflectt/config.json and restart.