What a node can't do
Not every machine can do everything. A node checks what its machine supports each time it reports, and its page shows each missing feature where you would use it, with the reason. Jaah refuses the same action with the same reason if you try it another way, so nothing is set up that can't work.
A node that lacks some features still runs your tasks: worktrees, agent sessions, git and pull requests work the same on every node.
On the Overview tabโ
- Start on boot: Yes when the machine runs systemd, the service manager most Linux machines use. Then the node starts by itself after a reboot, restarts if it stops, and updates itself. No means the machine doesn't run systemd, for example a node installed inside a container. You start the node again yourself after the machine restarts.
- Tailscale SSH: Yes when Tailscale SSH is turned on for the node, so people on your network can open a shell on it. No means it isn't turned on for this node's Tailscale.
A row is missing when the node hasn't reported that feature yet, for example a node running an older version.
Elsewhere on the node pageโ
The tab where you would use the feature shows the reason instead.
- NodeLinks: shared folders need systemd, a machine that can mount them, and the EFS mount helper. A node in a container can't mount them, so the tab says why at the top and Attach is greyed with the same reason. NodeLinks already attached stay listed.
- Shape: a MicroVM node needs systemd and an x86_64 Ubuntu 26.04 machine. On another machine the reason shows under Shape, and Jaah refuses a change to MicroVM. A node that is already MicroVM can always be switched back.
- GitHub Runners: self-hosted runners need systemd, so the tab shows the reason instead of a way to set them up.
- Running several nodes on one machine needs systemd, real root and rootless Docker on it. A machine without them can't host more nodes.
To get a feature back, install the node on a machine that has it: a regular Linux machine or a cloud machine rather than a container. See Add a node.
Relatedโ
- Add a node: what the install command skips inside a container.
- Choose a node's shape: Legacy, MicroVM and Whole-node VM.
- Run GitHub runners on a node: the runner pool a node with systemd can hold.
- Attach a NodeLink to nodes: shared folders across nodes.