> ## 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.

# VM Creation and OS Installation

> How to create a new VM manually in MacStadium Private Cloud: configure VM settings, attach an ISO, set a static IP, and install the OS via console.

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](/iaas/x86-vms-private-cloud-vms/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**.

<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/29997155691931.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=29c427a14b142d423427708d05ef1dd2" alt="Private Cloud Machines Dashboard with New VM button" width="762" height="520" data-path="images/attachments/29997155691931.png" />

*New VM*

3. On the *Select Type* tab, select **New VM** and click **Next.**

New VM is a blank recipe that allows for manual OS installation.

<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/29997364030363.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=421b1c724fa52e508bac97cef5499da3" alt="Private Cloud Select Type tab with New VM option selected" width="763" height="524" data-path="images/attachments/29997364030363.png" />

Select Type Tab

4. The *Virtual Machine Settings* tab opens.

<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/29997338332955.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=63b035d2a6f8b5660414a5c3e4fd140b" alt="Private Cloud Virtual Machine Settings tab" width="763" height="524" data-path="images/attachments/29997338332955.png" />

*Virtual Machine Settings Tab*

5. In the *VM Recipe Instance* box, complete the following fields:

* **Name**

* **Cores**

* **RAM**

* **Cluster** (can be left as *Default*)

* **OS Family**

<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/29998396849947.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=bda14f015c4c8bcf9e8a8bc182abc305" alt="Private Cloud VM Recipe Instance fields showing Name, Cores, RAM, Cluster, and OS Family" width="435" height="565" data-path="images/attachments/29998396849947.png" />

*VM Recipe Instance*

It is important that the OS Family matches the OS type installed.

6. 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*

*<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/29998373270427.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=7e8ea255514a4ebd76434b2ba00edc4b" alt="Private Cloud Drives section with CD-ROM Drive and OS Drive Interface settings" width="441" height="585" data-path="images/attachments/29998373270427.png" />*

*Drives*

7. In the Network box, make sure the Create Network Interface is checked and select the interface from the dropdown.

<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/29998373273243.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=fe3d961c62ba5287b5b47606b0699dd8" alt="Private Cloud Network section with Create Network Interface checked" width="441" height="289" data-path="images/attachments/29998373273243.png" />

*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.

8. Click **Submit**.

<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/29998396861979.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=f9e6b56cf066f1664239b06aae964310" alt="Private Cloud Virtual Machine Settings with Submit button" width="769" height="528" data-path="images/attachments/29998396861979.png" />

*Submit*

9. The new VM screen opens. Click the **Power** button and the *Confirmation box* opens.

10. Click **Power On**.

<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/29998373283099.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=848e203e12d6b46b615a137150513c78" alt="Private Cloud Power On confirmation dialog" width="769" height="528" data-path="images/attachments/29998373283099.png" />

*Power On*

11. Next, the OS must be installed and configured. To access the machine, click **Console**.

<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/29998396869659.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=ee1a11ddabd2ab3cdbce1e1021e46ab7" alt="Private Cloud VM page with Console button highlighted" width="769" height="528" data-path="images/attachments/29998396869659.png" />

*Console Button*

12. The **Console** opens.

<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/29998373288731.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=d64b5c759a97c7717f97dc2d37fcd611" alt="Private Cloud console showing VM display output" width="769" height="528" data-path="images/attachments/29998373288731.png" />

*Console*

Manually deployed VMs use a virtual screen, rather than a virtual terminal, meaning that text cannot be copied from the terminal.

13. Use the console to install the OS as usual.

14. 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:

<img src="https://mintcdn.com/macstadiuminc/dU1lCoT-Tf9PRIOx/images/attachments/29998535767707.png?fit=max&auto=format&n=dU1lCoT-Tf9PRIOx&q=85&s=ef61b6c3f47a04b7c00e51370ca97ab7" alt="Ubuntu Server network configuration screen with manual IP address fields" width="769" height="528" data-path="images/attachments/29998535767707.png" />*Manual 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.

15. Complete the installation as usual. Most Linux distributions include drivers for Virtio, which is required for optimal performance when virtualizing hardware.
