Roboflare
Getting started

Install the CLI

Build the rf CLI from source and log in with a portal token.

rf is the Roboflare command-line client. It talks to the same API the dashboard uses, so anything you do in the UI you can script.

Build from source

git clone https://github.com/upsurge/roboflare.git
cd roboflare/cli
cargo build --release
sudo cp target/release/rf /usr/local/bin/rf

Verify the install:

rf --version

Get a portal token

Log into the org portal at https://roboflare.pages.dev (or your self-hosted dashboard) and copy your portal token. Portal tokens look like rf_org_<hex> for the bootstrap admin token, or rf_user_<hex> for tokens issued to org users.

Portal tokens grant full org access at the role they were issued for. Treat them like SSH keys — never commit them, never paste them into shared Slack channels.

Log in

rf login
# Portal token: rf_org_<paste here>
# Logged in

rf login writes credentials to ~/.config/roboflare/credentials.toml. By default the CLI points at https://api.roboflare.com. Override per command with --base-url, or edit the credentials file directly if you self-host.

Log out

rf logout

This removes the local credentials file. Tokens themselves are not revoked server-side; revoke at the dashboard or with POST /api/org-users/{id}/revoke.

Next

You have a working CLI but no robots. Continue to Enroll a robot.

On this page