Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.macstadium.com/llms.txt

Use this file to discover all available pages before exploring further.

Before following these steps, you need a bootable ISO uploaded to your cluster’s Media Images repository. If you haven’t done that yet, follow the steps in Creating a New VM Manually under the Uploading Images section, then return here.
  1. Once the file completes the download process and the files appear in the Media Images page, Navigate to the Machines Dashboard.
  2. Click New VM.
Private Cloud Machines Dashboard with New VM button New VM
  1. On the Select Type tab, select New VM and click Next.
New VM is a blank recipe that allows for manual OS installation. Private Cloud Select Type tab with New VM option selected Select Type Tab
  1. The Virtual Machine Settings tab opens.
Private Cloud Virtual Machine Settings tab Virtual Machine Settings Tab
  1. In the VM Recipe Instance box, complete the following fields:
  • Name
  • Cores
  • RAM
  • Cluster (can be left as Default)
  • OS Family
Private Cloud VM Recipe Instance fields showing Name, Cores, RAM, Cluster, and OS Family VM Recipe Instance It is important that the OS Family matches the OS type installed.
  1. In the Drives box:
  • Create a CD-Rom Drive , select Use Local Media Image
  • Attach Selected iso to CD-ROM , select the file that was previously uploaded into Media Images
  • OS Drive Interface , select Virtio-SCSI
Private Cloud Drives section with CD-ROM Drive and OS Drive Interface settings Drives
  1. In the Network box, make sure the Create Network Interface is checked and select the interface from the dropdown.
Private Cloud Network section with Create Network Interface checked Network Unlike OS Recipe templates, manually created VMs require that IP configuration be done at the OS level, and cannot be configured when deploying the VM.
  1. Click Submit.
Private Cloud Virtual Machine Settings with Submit button Submit
  1. The new VM screen opens. Click the Power button and the Confirmation box opens.
  2. Click Power On.
Private Cloud Power On confirmation dialog Power On
  1. Next, the OS must be installed and configured. To access the machine, click Console.
Private Cloud VM page with Console button highlighted Console Button
  1. The Console opens.
Private Cloud console showing VM display output Console Manually deployed VMs use a virtual screen, rather than a virtual terminal, meaning that text cannot be copied from the terminal.
  1. Use the console to install the OS as usual.
  2. The IP address configuration must be set manually as a part of installation. The process for this can differ, depending on the OS installed. In this example, we are setting a manual IP address for Ubuntu Server 24.04:
Ubuntu Server network configuration screen with manual IP address fieldsManual IP Address Assignment DHCP is not supported. An IP address must be manually assigned, using a free IP address on the IP plan. All fields must be completed to ensure network connectivity.
  1. Complete the installation as usual. Most Linux distributions include drivers for Virtio, which is required for optimal performance when virtualizing hardware.