Skip to main content

Choose a node's shape

A node's shape is how it runs its sessions. Legacy: sessions share the node. MicroVM: each session runs in its own VM. Whole-node VM: the whole node runs in one VM. You pick it when you add the node, and can change it later on the node's Shape tab. Only the shapes the node and its machine can run are offered.

Who can do this: adding a node requires the org admin role. Changing a node's shape requires the org admin role and the permission to edit nodes; without them, the Shape tab is read-only. It is read-only too on a node the operator locked, or one shared with other organizations.

Plan: MicroVM needs your plan's MicroVM feature, and Whole-node VM its Whole-node VM feature. The Shape tab shows only while your plan includes MicroVM. See Check your plan and limits.

Pick a shape when you add a node​

  1. In the sidebar, select Directory, then the Machines tab.
  2. Select New node.
  3. Pick where the node runs. Whole-node VM is offered only for Launch in your cloud with Ubuntu, or a Linux Your machine.
  4. On the next step, set the machine's fields as usual. Shape shows below them when more than Legacy is offered.
  5. Pick Legacy, MicroVM or Whole-node VM. MicroVM is picked for you when offered. Select Next.
  6. Enter a Name and Projects, then select Next.
  7. Check the Shape row in the summary, then select Create.

If the machine turns out unable to run the shape you picked, the node gets Legacy. The whole flow is in Add a node.

Change a node's shape​

  1. In the sidebar, select Directory, then the Machines tab.
  2. Select the node's name, then its Shape tab.
  3. Open the Shape field and pick another shape. If the node can't run MicroVM, the reason shows under the field.
  4. To MicroVM: Turn on MicroVM asks first, since each task then runs in its own VM. Select Turn on.
  5. To or from Whole-node VM: Change to and the shape's name asks first, since the node is installed again. Select Change.
  6. Back from MicroVM to Legacy: nothing asks; the change applies at once.
  7. Check the sizes below the field: VM size on a Whole-node VM node, or Size, each session's VM, otherwise.

A change applies at once; there is no Save. If it fails, the tab says Couldn’t change the shape to and the shape's name.

Every field on the Shape tab is described in Machines. How nodes, slots and sessions fit together is in How nodes work.