Skip to content

feat(aps): utm how to guides #4846

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Apr 15, 2025
Merged

feat(aps): utm how to guides #4846

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
92a809f
feat(aps): utm how to guides
bene2k1 Apr 15, 2025
fa7c694
Apply suggestions from code review
bene2k1 Apr 15, 2025
a56ca3f
Apply suggestions from code review
bene2k1 Apr 15, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
108 changes: 58 additions & 50 deletions menu/navigation.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1127,6 +1127,14 @@
"label": "Upgrade to a beta version of macOS",
"slug": "upgrade-macos-to-beta"
},
{
"label": "Setup a virtual machine (VM) with UTM",
"slug": "setup-vm-with-utm"
},
{
"label": "Test MDM workflows using a VM",
"slug": "test-mdm-workflows"
},
{
"label": "Reboot a Mac mini",
"slug": "reboot-mac-mini"
Expand Down Expand Up @@ -3300,7 +3308,7 @@
"slug": "faq"
},
{
"items": [
"items": [
{
"label": "Order an InterLink",
"slug": "order-interlink"
Expand All @@ -3310,61 +3318,61 @@
"slug": "complete-provisioning"
},
{
"label": "Configure an InterLink",
"slug": "configure-interlink"
},
{
"label": "Create a routing policy",
"slug": "create-routing-policy"
},
{
"label": "Delete an InterLink",
"slug": "delete-interlink"
}
],
"label": "How to",
"slug": "how-to"
},
{
"items": [
{
"label": "InterLink API Reference",
"slug": "https://www.scaleway.com/en/developers/api/interlink/"
}
],
"label": "API/CLI",
"slug": "api-cli"
},
{
"items": [
{
"label": "InterLink overview",
"slug": "overview"
},
{
"label": "InterLink provisioning",
"slug": "provisioning"
},
{
"label": "Configuring an InterLink",
"slug": "configuring"
"label": "Configure an InterLink",
"slug": "configure-interlink"
},
{
"label": "Create a routing policy",
"slug": "create-routing-policy"
},
{
"label": "Delete an InterLink",
"slug": "delete-interlink"
}
],
"label": "How to",
"slug": "how-to"
},
{
"label": "InterLink statuses",
"slug": "statuses"
"items": [
{
"label": "InterLink API Reference",
"slug": "https://www.scaleway.com/en/developers/api/interlink/"
}
],
"label": "API/CLI",
"slug": "api-cli"
},
{
"label": "Using BGP communities",
"slug": "bgp-communities"
"items": [
{
"label": "InterLink overview",
"slug": "overview"
},
{
"label": "InterLink provisioning",
"slug": "provisioning"
},
{
"label": "Configuring an InterLink",
"slug": "configuring"
},
{
"label": "InterLink statuses",
"slug": "statuses"
},
{
"label": "Using BGP communities",
"slug": "bgp-communities"
}
],
"label": "Additional Content",
"slug": "reference-content"
}
],
"label": "Additional Content",
"slug": "reference-content"
}
],
"label": "InterLink",
"slug": "interlink"
},
"label": "InterLink",
"slug": "interlink"
},
{
"items": [
{
Expand Down
Binary file added pages/apple-silicon/how-to/assets/scaleway-aps-utm-1.webp
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added pages/apple-silicon/how-to/assets/scaleway-aps-utm-2.webp
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added pages/apple-silicon/how-to/assets/scaleway-aps-utm-3.webp
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added pages/apple-silicon/how-to/assets/scaleway-aps-utm-4.webp
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
80 changes: 80 additions & 0 deletions pages/apple-silicon/how-to/setup-vm-with-utm.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
---
meta:
title: How to setup a VM with UTM on a hosted Mac mini
description: Learn how to create a fully independent and functional virtual machine inside a Scaleway Mac using UTM, a powerful virtualization tool for macOS.
content:
h1: How to setup a VM with UTM on a hosted Mac mini
paragraph: Learn how to create a fully independent and functional virtual machine inside a Scaleway Mac using UTM, a powerful virtualization tool for macOS.
tags: vm utm virtual-machine
dates:
validation: 2025-04-15
posted: 2025-04-15
categories:
- bare-metal
---



This guide explains the process to create a fully independent and functional virtual machine inside a Scaleway Mac using UTM, a powerful virtualization tool for macOS.
UTM is free and open-source software that leverages Apple's Hypervisor framework and QEMU to provide virtualization capabilities.

<Macro id="requirements" />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/)
- A [Mac mini](/apple-silicon/how-to/create-mac-mini/)
- [VNC access](/apple-silicon/how-to/access-remote-desktop-mac-mini/) to your Mac

## Installating UTM

1. Download and install UTM on the Mac mini:
* From the official [Mac App Store](https://apps.apple.com/us/app/utm-virtual-machines/id1538878817) or
* Directly from the [official website](https://getutm.app/).
2. Download the macOS IPSW file.
The IPSW file is a compressed a file format used to install iOS, iPadOS, tvOS, HomePod, watchOS, macOS firmware for devices equipped with Apple silicon.
* Obtain the macOS IPSW file from the official [Apple Developer website](https://developer.apple.com/download/).
<Message type="note">
You need an [Apple Developer account](/apple-silicon/troubleshooting/cant-create-apple-account/) to access these files.
</Message>
3. Create a new virtual machine:
* Open UTM and click the "+" button to create a new VM.
* Select "Virtualize" and then "macOS".
* Browse and select your downloaded IPSW file.
* Configure your VM's properties:
* Set your desired CPU cores (recommended at least 2 cores).
* Allocate RAM (recommended at least 4GB).
<Lightbox src="scaleway-aps-utm-1.webp" size="medium" alt="The RAM allocation window of UTM with 4096 MB of RAM selected" />
* Configure the disk storage size (recommended at least 64GB).
<Lightbox src="scaleway-aps-utm-2.webp" size="medium" alt="The disk size confgiration window of UTM with 64GB of storage chosen" />
* Click "Save" to create the VM.
<Lightbox src="scaleway-aps-utm-3.webp" size="medium" alt="Summary of the VM configuration displaying the Save button to apply the configuration" />
4. Start and set Up your macOS VM:
* Once the VM is installed with your properties, click the "Run" button in UTM.
* A GUI window will open displaying your VM.
<Lightbox src="scaleway-aps-utm-4.webp" size="medium" alt="Mac OS setup wizard" />
* Follow the macOS installation process:
* Select language preferences.
* Set up your Apple ID (optional).
* Create a user account with username and password.
* Choose time zone and other basic settings.
* Wait for the installation to complete.

## Troubleshooting
### You are experiencing IPSW compatibility issues
- Ensure your IPSW file is compatible with UTM by checking the following points:
- The macOS version is supported by your UTM version
- The IPSW architecture matches your Mac's architecture (in our case, `arm64` for Apple silicon architecture)
- The IPSW file is not corrupted (verify checksums if available)
- For performance issues, try adjusting the allocated CPU cores and RAM

## Additional tips
- Take snapshots of your VM before making significant changes
- Use shared folders to easily transfer files between the host and guest systems
- For testing purposes, consider creating multiple VMs with different macOS versions

<Message type="tip">
For more advanced information about UTM, refer to the [official UTM documentation](https://docs.getutm.app/)
</Message>

This setup allows you to run a complete and isolated macOS environment within your Scaleway mac instance, perfect for testing applications, MDM profiles, or other macOS-specific tasks.
56 changes: 56 additions & 0 deletions pages/apple-silicon/how-to/test-mdm-workflows.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
meta:
title: How to test MDM workflows using a VM
description: This page explains how to test MDM workflows useing a VM
content:
h1: How to test MDM workflows using a VM
paragraph: This page explains how to test MDM workflows using a VM
tags: vm utm mdm
dates:
validation: 2025-04-15
posted: 2025-04-15
categories:
- bare-metal
---

Scaleway's hosted Mac mini with UTM as a hypervisor provides a unique and powerful platform for testing and validating Mobile Device Management (MDM) solutions.

This documentation guide is designed to help you get started with testing MDM automation and deployment workflows on a Scaleway Mac mini with UTM.
It provides step-by-step instructions for enrolling a VM in an MDM server, testing MDM commands and deployment, and manually installing configuration profiles. Whether you're an MDM administrator, a developer, or a QA engineer.

By following this guide, you will be able to create a robust and isolated testing environment for your MDM solution, allowing you to validate its functionality, performance, and scalability.

<Macro id="requirements" />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/)
- A [Mac mini](/apple-silicon/how-to/create-mac-mini/)
- [VNC access](/apple-silicon/how-to/access-remote-desktop-mac-mini/) to your Mac
- [Installed](/apple-silicon/how-to/setup-vm-with-utm/) UTM and created a virtual machine (VM)
- An MDM server (such as microMDM, Jamf, InTune, or other MDM provider) configured and ready for use

## MDM enrollment

1. Install and configure your MDM server according to the provider's documentation.
2. Create an enrollment profile from your MDM solution.
3. On your VM, navigate to **System Settings** > **General** > **Device Management**.
4. Complete the enrollment process specific to your MDM provider to connect your VM to your MDM server.

### Testing MDM commands and deployment

1. Use your MDM's admin console to push configurations and commands to the enrolled VM.
2. Verify that MDM commands are properly received and executed on the VM.
3. Test software deployment, configuration profiles, and policies to ensure they are working as expected.
4. Simulate real-world device management scenarios to ensure your MDM setup is working correctly.

### Manual configuration profile installation (optional)

If needed, you can manually install a configuration profile on your VM:

1. Download your configuration profile (`.mobileconfig` file) from your MDM provider.
2. On your VM, go to **System Settings** > **General** > **Device Management**.
3. Click the "+" button and select your profile.
4.Follow the prompts to install and activate the profile.

By following these steps, you should be able to successfully enroll your VM in your MDM server and test MDM commands and deployment.