Fleets
A fleet is the set of machines joined to one relay, and it is Cmdop’s grouping boundary: the roster you see, the machines you can reach, and the scope fleet-level tools operate over. A machine joins with that fleet’s join key. One machine on its own is a machine workspace; “fleet” is the word for many of them together.
One machine on its own is a machine workspace. “Fleet” is the word for many of them under one relay context — the two are different things, not synonyms.
Joining one
A machine joins a fleet with that fleet’s join key:
cmdop join <join-key>
cmdop join <join-key> --server https://my.example.comJoining is symmetric across a hosted relay and a self-hosted one — the same command, differing only in the key and the address. There is no browser login and no device-code flow.
A machine can be configured for more than one relay. cmdop remotes list and
cmdop remotes use <name> select which relay entry is active; the machine list
you can reach follows from the active one.
What membership gives you
- A roster. Joined machines appear with a human-readable name and an online state; a machine is online only while its agent is connected.
- Reachability between machines. Joined agents can ask each other for work through the relay. See Machine collaboration.
- A fleet-level contact. The relay presents an orchestrator you can address
as a machine named
server, for work that spans machines rather than targeting one.
What membership does not give you
A join key is a joining credential, not an access-to-everything one. It lets a machine present itself to its relay. It does not by itself grant an interactive terminal on another machine, and it does not satisfy a target machine’s connection PIN. Those are separate checks with separate owners — see Identity and access.
Plans are counted in machines and relay addresses; see Pricing.
Common questions
What is a Cmdop fleet?
A fleet is the set of machines joined to one relay. It is the roster boundary for machine visibility, reachability, and fleet-level tools.
Does a join key give terminal access to every machine?
No. A join key lets a machine join a relay. Interactive terminal access uses the target relay door’s authentication and, when armed, that machine’s connection PIN.
Can one machine belong to more than one fleet?
It can have multiple relay entries and switch the active one with
cmdop remotes use <name>. The machine list and fleet-level tools follow the
currently active relay context.
Cmdop