Install the agent

Get a robot reporting to the fleet in two steps

1. Get an API key

  1. Open the Fleet overview page.
  2. Click + Add robot and name it.
  3. Click Generate API key and copy the key shown — it's only shown once.

2. Run the installer on the robot

On the Raspberry Pi (or any Linux box) you want to monitor, run:

bash <(curl -fsSL https://cortex-io.netlify.app/install.sh)

Paste the API key from step 1 when it asks for it. That's the only thing you'll be asked for — the installer sets up a Python virtualenv, installs dependencies, and starts the agent immediately: as a systemd service (so it survives reboots) when systemd and sudo are available, or directly in the background otherwise. Either way, the robot appears on the Fleet overview page within a few seconds — no extra command needed.

Notes

  • Use bash <(curl ...), not curl ... | bash — the former keeps your real terminal attached, so pasting the key works correctly.
  • Safe to re-run at any time.
  • Running ROS2 in Docker? The installer auto-detects a running container by name and wires it up automatically — nothing extra to configure.
  • Installing over SSH without a terminal attached (e.g. ssh host '...' without -t)? There's nothing to paste into, so set the key directly: ROBOT_API_KEY=... bash <(curl -fsSL https://cortex-io.netlify.app/install.sh)