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.

In addition to deploying VMs using recipes, virtual machines may also be created manually. This is primarily done when specific versions of OSes are required (for instance, desktop versions of Windows). Manually deployed VMs take additional effort to configure when compared to deployments from recipe. MacStadium recommends the use of recipes for VM deployment whenever possible.

Uploading Images

For manually created VMs, guest operating systems are installed by adding a CD-ROM device with media file set to a bootable install ISO. Install ISOs are stored in the Media Images repository. To upload an ISO for installation:
  1. Select Machines → Media Images.
Private Cloud sidebar with Media Images option selected Media Images
  1. The Media Images page shows stored install disk and uploaded VM images. There are two ways to upload images for install:
    • Upload from URL - Private Cloud downloads the image from a remote URL
    • Upload - The image is uploaded from the connected desktop
In this example, we will use Ubuntu Server as the install image.

Upload from URL

Upload from URL is the recommended approach, as Private Cloud can often download images faster directly from the repository.
  1. Find a direct link for the install media for the desired OS. In this case, Ubuntu only offers direct links through their mirror, so we’ll select Alternative downloads, and get the URL from a mirror.
Ubuntu Server download page showing Alternative downloads optionExample: Ubuntu Server Download Ubuntu mirror download page with direct ISO linksDirect Download links from Mirror
  1. Upload the image to Private Cloud from the mirror. Return to the Media Images pages.
  2. Select Upload from URL.
Private Cloud Media Images page with Upload from URL button Upload from URL
  1. The Upload from URL dialog box opens.
Private Cloud Upload from URL dialog box Upload from URL
  1. Paste the download link into the Upload from URL page.
Private Cloud Upload from URL field with download link pasted Copy Link
  1. Click Submit , and the Upload Process begins.
Private Cloud Media Images page showing upload progressUpload Process

Upload Directly

  1. To upload an ISO from the connected computer, choose Upload on the Media Images screen. The Upload Files screen appears.
Private Cloud Upload Files screen for local ISO upload Upload Files Screen
  1. Click Upload , and the Upload Process begins.
Private Cloud Media Images page showing direct upload progress Upload Process