diff --git a/menu/navigation.json b/menu/navigation.json index 8c65f19497..6d6867bb14 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -1127,6 +1127,14 @@ "label": "Upgrade to a beta version of macOS", "slug": "upgrade-macos-to-beta" }, + { + "label": "Set up 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" @@ -3300,7 +3308,7 @@ "slug": "faq" }, { - "items": [ + "items": [ { "label": "Order an InterLink", "slug": "order-interlink" @@ -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": [ { diff --git a/pages/apple-silicon/how-to/assets/scaleway-aps-utm-1.webp b/pages/apple-silicon/how-to/assets/scaleway-aps-utm-1.webp new file mode 100644 index 0000000000..92ee4327a9 Binary files /dev/null and b/pages/apple-silicon/how-to/assets/scaleway-aps-utm-1.webp differ diff --git a/pages/apple-silicon/how-to/assets/scaleway-aps-utm-2.webp b/pages/apple-silicon/how-to/assets/scaleway-aps-utm-2.webp new file mode 100644 index 0000000000..ea949ef8fe Binary files /dev/null and b/pages/apple-silicon/how-to/assets/scaleway-aps-utm-2.webp differ diff --git a/pages/apple-silicon/how-to/assets/scaleway-aps-utm-3.webp b/pages/apple-silicon/how-to/assets/scaleway-aps-utm-3.webp new file mode 100644 index 0000000000..d47d34e643 Binary files /dev/null and b/pages/apple-silicon/how-to/assets/scaleway-aps-utm-3.webp differ diff --git a/pages/apple-silicon/how-to/assets/scaleway-aps-utm-4.webp b/pages/apple-silicon/how-to/assets/scaleway-aps-utm-4.webp new file mode 100644 index 0000000000..db99e46ba6 Binary files /dev/null and b/pages/apple-silicon/how-to/assets/scaleway-aps-utm-4.webp differ diff --git a/pages/apple-silicon/how-to/setup-vm-with-utm.mdx b/pages/apple-silicon/how-to/setup-vm-with-utm.mdx new file mode 100644 index 0000000000..e577b69e40 --- /dev/null +++ b/pages/apple-silicon/how-to/setup-vm-with-utm.mdx @@ -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. + + + +- 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/). + + You need an [Apple Developer account](/apple-silicon/troubleshooting/cant-create-apple-account/) to access these files. + +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). + + * Configure the disk storage size (recommended at least 64 GB). + + * Click "Save" to create the VM. + +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. + + * 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 + + + For more advanced information about UTM, refer to the [official UTM documentation](https://docs.getutm.app/) + + +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. diff --git a/pages/apple-silicon/how-to/test-mdm-workflows.mdx b/pages/apple-silicon/how-to/test-mdm-workflows.mdx new file mode 100644 index 0000000000..693aabc57b --- /dev/null +++ b/pages/apple-silicon/how-to/test-mdm-workflows.mdx @@ -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. + + + +- 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. \ No newline at end of file