Relay entries
cmdop remotes is the registry of relays this machine connects to. It is
the counterpart of cmdop server, which runs a relay other
machines connect to.
cmdop remotes list
cmdop remotes add <url>
cmdop remotes use <slug>
cmdop remotes show
cmdop remotes remove <slug>cmdop remote is an alias for cmdop remotes. Running cmdop remotes with no
subcommand prints a brief list.
Slugs
Every entry is addressed by a slug, which Cmdop derives from the relay URL rather than letting you choose it:
| URL | Slug |
|---|---|
https://relay.example.com | relay.example.com |
http://192.168.1.10:8080 | 192-168-1-10_8080 |
Run cmdop remotes list to see the slug for each entry; the active one is
marked.
Add an entry
cmdop remotes add https://relay.example.com
cmdop remotes add https://relay.example.com --name "Prod relay"
cmdop remotes add https://relay.example.com --no-check| Flag | Purpose |
|---|---|
--name <text> | Human-readable display name shown in cmdop remotes list. |
--no-check | Skip the health probe — use when the relay is not reachable yet but you want the entry staged. |
--insecure | Skip TLS verification for the probe. Self-signed self-hosted relays only. |
--force | Overwrite an existing entry with the same slug. |
Adding an entry does not join this machine to that relay. Run
cmdop join <join-key> afterwards against that
relay.
Inspect and switch
cmdop remotes list
cmdop remotes list --json
cmdop remotes show
cmdop remotes show <slug>
cmdop remotes show --reveal-secrets
cmdop remotes use <slug>
cmdop remotes use <slug> --no-checkshow with no argument shows the active entry. Stored credentials are masked
unless you pass --reveal-secrets.
use sets the active relay. It probes the relay first, but a failed probe only
prints a warning — the switch still happens. --no-check suppresses the probe.
Remove an entry
cmdop remotes remove <slug>
cmdop remotes remove <slug> --yes-y/--yes skips the confirmation prompt. rm and delete are aliases. If
you remove the active entry, no relay is active until you pick another one.
Cmdop