Skip to main content

Delete a node

Delete a node when you no longer want it in your organization: a machine you're retiring, one that was replaced, or one that never finished joining. Deleting it removes every slot on it and ends whatever runs in them, so let its work finish first. To take a node out of service for a while instead, see Drain or disable a node.

Who can do this: Org Owners and Admins. Other members don't see Delete.

Let its work finish​

  1. In the sidebar, select Directory, then the Machines tab.
  2. Find the node's row, select ⋯ at its end, then Drain. The node takes no new tasks and disables itself once the ones it runs are done.
  3. Select the node's name and read Running tasks on the Overview tab: the tasks still running there. Wait until it reaches zero.

Delete it​

  1. Back on Machines, select ⋯ at the end of the node's row.
  2. Select Delete. The Delete node dialog lists what happens: how many slots on it are deleted and their folders erased, that runners and console sessions in them are ended without being asked, and that its instance is terminated if Jaah launched it.
  3. For a node that shares its host with other nodes, the dialog instead says the node goes offline and its home on the host is erased. On the host's last node it also offers Also delete host, ticked, and says what that does: the cloud instance is terminated, Jaah is uninstalled from the machine, or a hosting Jaah provides ends. Untick it to keep the host.
  4. Select Delete.
  5. Check the message that appears, such as build-01 deleted., and that the row is gone from the list.

You can also delete from the node's own page: on its Overview tab, select More, then Delete.

What else to know​

  • A node that is still online is deleted anyway. If it keeps reporting, it shows again as an unregistered node; stop Jaah on the machine, or delete its host, to end that.
  • A node Jaah hosts for you: its hosting ends with it, and unused days are credited to your next bill or refunded.
  • A node that never registered is only removed from the list. It shows again if it connects.
  • Deleting can't be undone. To use the machine again, add a node.