Keep a fleet roster current

There is no roster to synchronize and no sync command to run. A machine is in your fleet because you ran cmdop join on it against a relay, and it shows as available because it is currently reporting in. So when a machine is missing, the answer is almost always that it joined a different relay, which cmdop remotes show on that machine settles.

Fleet membership begins on each machine. There is no user-facing “fleet sync” step to run: joining plus the selected relay is the source of truth for membership, and live status is the source of truth for availability.

Join a machine

The web console’s Server area hands you a ready-to-run cmdop join command with the join key already filled in — that is the happy path. Run it on the machine you are adding:

cmdop join <join-key>
cmdop status

Add --server <url> when the machine should join a relay that is not already its active one.

Read the roster

cmdop connect --list
cmdop connect --list --online
cmdop machines

connect --list shows the machines in the active relay context, and --online narrows that to the ones currently reporting in. cmdop machines is wider: it shows machines across all of your relay contexts, which is what you want when a machine seems to have vanished — it may simply be joined to another relay.

Being online is a live signal, not a promise that a terminal attach will succeed. A machine can be online and still not be remotely attachable.

Diagnose a missing machine

Run these on the machine that is missing from the roster:

cmdop doctor
cmdop status
cmdop remotes show
cmdop logs --lines 100

cmdop doctor is the diagnostic verb — it checks the machine’s own setup and names what is wrong. remotes show confirms which relay this machine is actually joined to, which is the single most common cause of a machine “missing” from a roster you are reading somewhere else.

Re-join only when the current join key is genuinely invalid, or when the machine is deliberately moving to another relay. Re-joining a healthy machine does not repair a roster.

Common questions

Is there a Cmdop fleet sync command?

No. Fleet membership comes from cmdop join on each machine. Live availability comes from the machine reporting in to its relay.

Why is a machine missing from my fleet roster?

Most often, the machine joined a different relay or is not currently reporting in. Run cmdop remotes show and cmdop status on that machine.

Should I re-join a healthy machine to fix the roster?

No. Re-join only when the join key is invalid or the machine is deliberately moving to another relay.