reoclo servers

reoclo servers ls
reoclo servers get <idOrSlug>
reoclo servers metrics <idOrSlug>
reoclo servers set-slug <idOrSlug> <newSlug>

Server commands cover read access plus slug renaming. Provisioning and runner installation continue to live in the dashboard.

Slugs

Every server has a tenant-unique slug — a URL- and shell-friendly identifier derived from the server’s name (e.g. Reoclo Production → reoclo-production). Slugs are the recommended way to refer to a server in CLI commands and tab completion:

reoclo logs tail --server reoclo-production --source container --name nginx
reoclo shell reoclo-pilot-01
reoclo exec reoclo-production -- df -h

Slugs are stable across renames — changing a server’s display name in the dashboard does not change its slug. To explicitly change a slug, use set-slug (see below).

Server names (with spaces or capitals) are still accepted for backward compatibility, but they’re no longer offered in tab completion.

ls

Lists every server in the active tenant with its slug, name, hostname, IP, status, and runner connection state.

$ reoclo servers ls
SLUG               NAME            HOSTNAME             IP           STATUS  RUNNER
reoclo-production  Reoclo Prod     prod-web-1.local     10.0.0.10    ACTIVE  v1.4.2
reoclo-pilot-01    Reoclo Pilot    staging-web.local    10.0.0.11    ACTIVE  v1.4.2
prawnwire-mail     Prawnwire Mail  mail-bastion.local   10.0.0.12    ONLINE  v1.4.2

JSON output for scripting:

reoclo servers ls -o json

get <idOrSlug>

Shows the full record for one server: hostname, IP, environment, runner version, last seen timestamp, attached domains, and any health check failures.

You can pass any of: the slug, the UUID, or the human-readable name. The CLI resolves these through a small local cache to avoid an extra round trip.

reoclo servers get reoclo-production
reoclo servers get 019dc1a8-841f-7102-ac5d-3ee9e9353795
reoclo servers get "Reoclo Production"   # backward compatibility

metrics <idOrSlug>

Returns the most recent CPU, memory, and disk readings reported by the runner.

$ reoclo servers metrics reoclo-production
cpu:   12% (1m), 18% (5m), 22% (15m)
mem:   3.2 GB / 8.0 GB (40%)
disk:  /        24 GB / 80 GB (30%)
       /var/lib 8.2 GB / 40 GB (20%)

set-slug <idOrSlug> <newSlug>

Changes a server’s slug. Tenant-scoped uniqueness is enforced — if the new slug is already in use by another server in the same tenant, the API returns 409.

$ reoclo servers set-slug reoclo-production prod
✓ slug updated: reoclo-production → prod

The slug must match ^[a-z0-9]+(?:-[a-z0-9]+)*$ (lowercase alphanumerics and hyphens, no leading/trailing/double hyphens).

Exit codes

Code	Meaning
0	Success
1	Network or server-side error
3	Authentication failure
5	Server not found

Related

• reoclo deployments — view deployments running on a server
• reoclo logs tail — tail logs from a server