Use more than one relay

You can register several relays on one machine and switch between them with cmdop remotes. What that never does is move the machine: a relay entry is a local connection profile, so switching the active one repoints the machine but carries no membership and no credentials with it. Belonging to two relays means running cmdop join against each one separately.

Relay entries are local connection profiles. Adding or selecting one does not move a machine between fleets and does not join it to a relay automatically.

1. Inspect the current relay

cmdop remotes list
cmdop remotes show

2. Add another relay

cmdop remotes add https://relay.example.com
cmdop remotes list

Cmdop probes the relay’s health before saving it. Use --no-check only to stage a relay you know is temporarily offline; the other TLS and probe options shown by cmdop remotes add --help are for self-hosted setups you have already approved.

A bare host address is interpreted as a self-hosted relay on its default ports; give a full https:// URL when the relay sits behind a proxy or a custom port. Adding an entry does not join this machine to that relay — that is the next step.

3. Select and join deliberately

cmdop remotes use <relay-slug>
cmdop remotes show
cmdop join <join-key-for-that-relay>
cmdop status

The join key must belong to the selected relay.

remotes use is a real switch, not just a config edit: it repoints this machine, rebuilds its authentication for the new relay, verifies the result, and asks a running agent to reconnect. What it does not do is transfer membership or copy credentials — credentials are per relay, so a machine that should belong to both relays joins each one separately.

Before removing an entry, confirm that no script or operator still depends on it. Use cmdop remotes plus explicit joining rather than copying credentials between relay profiles.

Its alias is cmdop remote, if that reads better in your notes.

Common questions

Can one machine use more than one Cmdop relay?

Yes. A machine can register several relay profiles and switch the active one with cmdop remotes use.

Does adding a relay join the machine to that fleet?

No. Adding a relay only saves a local connection profile. The machine must run cmdop join with that relay’s join key.

Are relay credentials copied between profiles?

No. Membership and credentials are per relay. Switching profiles does not copy or transfer them.