← Back to all docs
Start here•1 min read

Connect to Reflectt Cloud

Just signed up at app.reflectt.ai? Here's how to connect your first host and see real data in your dashboard.

What this is

Just signed up at app.reflectt.ai? Here's how to connect your first host and see real data in your dashboard.

Before you start

No special prerequisites called out for this guide.

Next best move

You're set. The dashboard is yours.

Connect to Reflectt Cloud

Just signed up? You're in the right place. This gets you from empty dashboard to connected host.

What you need

  • Your Reflectt Cloud account (you have this — you signed up)
  • A machine to run reflectt-node on (your laptop works fine)
  • 5 minutes

Step 1 — Get your join token

  1. Open https://app.reflectt.ai
  2. Go to Hosts → click Connect a host
  3. Copy the join token shown (it expires in 15 minutes, one-time use)

Step 2 — Install and connect

If you don't have reflectt-node installed:

BASH
npm install -g reflectt-node
reflectt host connect --join-token <your-token> --cloud-url https://app.reflectt.ai
reflectt start

Or, one-liner (no global install needed):

BASH
npx reflectt-node

You'll be prompted for your join token during setup.

Step 3 — Confirm you're connected

Go back to https://app.reflectt.ai → Hosts. Your machine should appear as Online within 30 seconds.

Once connected, the Overview and Usage pages will show live data from your node.

Troubleshooting

Token expired? Go back to Hosts and generate a new one — each token is one-time use.

Host shows offline after running the command? Try:

BASH
curl http://localhost:4445/health

If that returns an error, reflectt-node isn't running. Try reflectt start or npx reflectt-node.

Other issues? See the Troubleshooting guide.

What happens after you connect

  • Hosts page — shows your machine as online with status
  • Usage page — activity metrics for your node
  • Overview — live summary of tasks, agents, and activity

You're set. The dashboard is yours.