-
Notifications
You must be signed in to change notification settings - Fork 260
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.
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
Changes from all commits
Commits
Show all changes
3 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,78 @@ | ||
| --- | ||
| meta: | ||
| title: How to set up 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 set up 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 a 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 file format used to install iOS, iPadOS, tvOS, HomePod, watchOS, and 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 4 GB). | ||
| <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 64 GB). | ||
| <Lightbox src="scaleway-aps-utm-2.webp" size="medium" alt="The disk size configuration window of UTM with 64 GB 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 a 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-hosted Mac mini, perfect for testing applications, MDM profiles, or other macOS-specific tasks. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 using 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. The documentation is suitable for MDM administrators, developers, or QA engineers. | ||
|
|
||
| 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. |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.