Skip to main content

Nodes

A node is a machine your organization's tasks run on. It keeps worktrees, the working copies of your projects, and runs the runners that work in them. When a task starts, Jaah picks a node with a free worktree for its project and launches a runner there, so without a node that is online, enabled and open to the project, no task on that project can start.

A node can come from several places: bought from Jaah in Billing, launched in your own cloud account through a cloud connection, a machine you run yourself and register with a one-time command, or another node on a host your organization already has. Your plan can include nodes, and a node group can start cloud nodes for you; either way they appear on the Machines tab like any other.

A node shows two separate things. Its Status is ONLINE while it reports and OFFLINE once it stops. Whether it takes new tasks is Enabled, Draining (no new tasks; it disables itself when its running tasks finish) or Disabled. Neither draining nor disabling stops a task already running; Delete does, and removes every worktree on the node.

A node runs every project on All, or whose node groups include it, reaches the AI model through your model accounts, and fetches the credentials each task was given. The ideas behind all of this are in How nodes work.

Every column, tab and field on the Machines page is described in the Machines reference. The worktrees a node holds are covered in Worktrees; folders nodes share, and the network they need, in NodeLink.