Skip to content
StratumStratum Docs

Create a join code

A join code lets machines register with the cluster. Registering gives them no access: each machine still waits for your approval.

Sign in, then in Admin › Metal select Add node. Choose how long the code lives (1 hour, 4 hours, 24 hours or 7 days) and select Create join code. The dialog shows the address and the code, once.

Add node: the cluster's address and a join code, shown once.
Add node: the cluster's address and a join code, shown once.

Give the new machine the address and the code. See join-code.

  • The code is shown once and the cluster keeps no copy of it. Case, dashes and spaces do not matter. The last character is a check character, so a typo is caught on the machine.
  • One code serves a whole batch of machines until it expires or you revoke it.
  • The machine and the cluster prove the code to each other before the machine sends anything, so a machine that reaches the wrong address stops.
  • Ten wrong attempts burn the code. Create a new one.
  • While a code is live, every control-plane node listens on TCP 9444; with no live code the port is closed. The new machines must reach it.
Terminal window
stratumctl admin nodes join-code list
stratumctl admin nodes join-code revoke jc-4f7k2q9m

Revoke the code once the last machine has joined. Readiness reminds you (JoinCodeLiveAtPlannedSize) while a code is live and the cluster has its planned control-plane nodes.

Next: install the other nodes.