Offline docs (switch to live docs)                          UI-only  CLI-only

Overseeing individual virtual machines

Mastering virtual machine management with MAAS

If you have already taken the first step of setting up a VM host on MAAS, you're ready to delve into the art of managing your virtual machines (VMs). Whether it's adding, deleting, or configuring VMs, we've got you covered. Below are detailed guides for both UI and CLI methods, tailored to various MAAS versions.

How to add a VM from the MAAS UI

Creating a VM via the MAAS UI is straightforward. Here's a step-by-step guide:

  1. Navigate to KVM > .

  2. Choose the VM host by clicking on its name.

  3. Click on Add VM.

  4. If you wish, input a VM name.

  5. Choose between Use any available core(s) or Pin VM to specific core(s). If choosing the latter, specify core identities.

  6. Input the amount of RAM needed.

  7. For advanced settings like Domain, Zone, Resource pool, or Architecture, click on Show advanced and make your modifications.

  8. Optionally, you can Define interfaces.

  9. Add disks if necessary by selecting Add disks.

  10. Finally, click Compose machine to spawn your VM.

Extra Information

You'll find the newly composed VM in the 'Machines' tab after a brief period, during which it undergoes auto-commissioning. Resources are automatically deducted from the selected VM host.

How to add a VM from the MAAS UI (Additional Versions)

  1. From the VM host's details view, locate the 'Take action' drop-down menu and select 'Compose'.

  2. Choose your preferred storage pool from the provided drop-down list.

Note: When adding multiple disks, the last disk in the list will function as the boot disk.

  1. Click 'Compose machine'. You'll be redirected to the VM host detail view.

Your new machine will be auto-commissioned, and its resources will be deducted from the VM host. The 'Machines' tab will update to reflect these changes.

How to delete a VM

Deleting a VM in MAAS is as straightforward as deleting any other machine:

  1. Choose the machine from the machine list.

  2. Select 'Delete' from the 'Take Action' drop-down menu.

Hopefully, this documentation provides a comprehensive guide on VM management in MAAS. Would you like to know more? Feel free to ask questions.