Creating a Virtual Machine

You create a virtual machine from the Virtual Machines page with Create VM, which opens a three-step wizard: Target, Template, and Settings. The hypervisor must be online and have at least one network. To add one, see Managing Networks.

Select a Target

1. Select the hypervisor to create the VM on. Only online deployments are listed, each labeled with its type.
2. Select Proceed to Template.

Select a Template

1. Search the table and select the template to build from. The panel on the right shows its OS type, source, hardware profile, minimum memory, whether cloud-init is enabled, and disk count. To browse or create templates, see Templates.
2. Select Proceed to Settings.

Configure the Settings

The Settings step is one page of sections. Fields start from the template’s defaults.

Identification

CPU and Memory

1. Select the Virtual CPU Cores. The list offers 1 vCPU, then even counts up to the cores the hypervisor has available.
2. Enter the Memory. The minimum comes from the template. The form names the limit that applies if the value exceeds what the hypervisor can provide, which depends on the Startup toggles.

Disks

Each of the template’s disks is listed as a Template Disk or Template ISO. You can raise a Template Disk above its minimum size, but you cannot add blank disks at this stage. Windows templates also carry a Tool ISO holding the VirtIO drivers. See Windows Configuration.

The Storage Pool card shows the required and available storage, and warns if the VM needs more than the pool has free.

Network

The first interface is preset to the hypervisor’s default network. Change it, or select Add Interface for more. Each interface must use a distinct network. The delete button on an interface removes it, down to the last one.

Users

For templates with cloud-init, the Default User card configures the built-in gallium account:

1. Enter a Password (optional).
2. Select the SSH Keys to authorize. Keys marked auto-add in your inventory are preselected.

Templates without cloud-init show a message here instead of fields.

Configuration

For templates with cloud-init, paste cloud-init user data or a script into User Data or Script. Prefix it to declare its type: #cloud-config for user data, #!/bin/bash for a shell script, or #ps1 for PowerShell on a Windows template. Do not pass secrets such as passwords, API tokens, or private keys through this field.

Startup

Create the Virtual Machine

Select Create Virtual Machine. The hypervisor provisions the VM and the Console opens its detail page.