Getting started with the CLI

This walkthrough takes you from a fresh install through your first deployment. It assumes you already have a Reoclo account, at least one server, and at least one application configured. If you do not, follow the Quickstart first.

1. Install the CLI

If you have not already, follow the install guide and verify with:

reoclo --version

2. Log in

reoclo login

The CLI prints a short device code and opens your browser to the Reoclo dashboard. Approve the request and you are logged in. There is no API key to paste. Tokens are stored in your OS keyring (macOS Keychain, Linux Secret Service, or Windows Credential Manager) and refreshed automatically. On a headless machine without a keyring, the CLI falls back to a 0600-mode file under ~/.reoclo/.

See CLI Authentication for profile management, keyring controls, and headless flows.

Confirm the login worked:

reoclo whoami

For CI/CD, skip reoclo login and set REOCLO_AUTOMATION_KEY in the environment instead. See CI/CD automation and Automation Keys.

3. Explore your tenant

reoclo servers ls
reoclo apps ls
reoclo deployments ls

The default output is a human-readable table. Add -o json or -o yaml for machine-readable output:

reoclo servers ls -o json | jq '.[] | {id, name, status}'

4. Trigger your first deployment

reoclo apps deploy my-app

You can pass either an application slug or its UUID. To deploy a specific commit:

reoclo apps deploy my-app --ref deadbeef

Tail the build:

reoclo deployments ls --limit 1 -o json | jq -r '.[0].id' | xargs reoclo deployments logs --build

5. Manage environment variables

reoclo env ls --app my-app
reoclo env set --app my-app DATABASE_URL=postgres://...
reoclo env rm  --app my-app OLD_FLAG

Values are write-only via the API. reoclo env get is intentionally unsupported. View secrets in the dashboard if you need to read them back.

6. Manage profiles

If you work across multiple tenants or environments (staging, production), use named profiles:

reoclo login --profile staging --api https://api.staging.reoclo.com
reoclo profile use staging
reoclo whoami           # uses the staging profile
reoclo profile use default