Skip to content

Commit 073798b

Browse files
bene2k1nerda-codesRoRoJjcirinosclwy
authored
feat(aps): utm how to guides (#4846)
* feat(aps): utm how to guides * Apply suggestions from code review Co-authored-by: Néda <[email protected]> Co-authored-by: Rowena Jones <[email protected]> * Apply suggestions from code review Co-authored-by: Jessica <[email protected]> --------- Co-authored-by: Néda <[email protected]> Co-authored-by: Rowena Jones <[email protected]> Co-authored-by: Jessica <[email protected]>
1 parent 097598a commit 073798b

File tree

7 files changed

+192
-50
lines changed

7 files changed

+192
-50
lines changed

‎menu/navigation.json‎

Lines changed: 58 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1127,6 +1127,14 @@
11271127
"label": "Upgrade to a beta version of macOS",
11281128
"slug": "upgrade-macos-to-beta"
11291129
},
1130+
{
1131+
"label": "Set up a virtual machine (VM) with UTM",
1132+
"slug": "setup-vm-with-utm"
1133+
},
1134+
{
1135+
"label": "Test MDM workflows using a VM",
1136+
"slug": "test-mdm-workflows"
1137+
},
11301138
{
11311139
"label": "Reboot a Mac mini",
11321140
"slug": "reboot-mac-mini"
@@ -3300,7 +3308,7 @@
33003308
"slug": "faq"
33013309
},
33023310
{
3303-
"items": [
3311+
"items": [
33043312
{
33053313
"label": "Order an InterLink",
33063314
"slug": "order-interlink"
@@ -3310,61 +3318,61 @@
33103318
"slug": "complete-provisioning"
33113319
},
33123320
{
3313-
"label": "Configure an InterLink",
3314-
"slug": "configure-interlink"
3315-
},
3316-
{
3317-
"label": "Create a routing policy",
3318-
"slug": "create-routing-policy"
3319-
},
3320-
{
3321-
"label": "Delete an InterLink",
3322-
"slug": "delete-interlink"
3323-
}
3324-
],
3325-
"label": "How to",
3326-
"slug": "how-to"
3327-
},
3328-
{
3329-
"items": [
3330-
{
3331-
"label": "InterLink API Reference",
3332-
"slug": "https://www.scaleway.com/en/developers/api/interlink/"
3333-
}
3334-
],
3335-
"label": "API/CLI",
3336-
"slug": "api-cli"
3337-
},
3338-
{
3339-
"items": [
3340-
{
3341-
"label": "InterLink overview",
3342-
"slug": "overview"
3343-
},
3344-
{
3345-
"label": "InterLink provisioning",
3346-
"slug": "provisioning"
3347-
},
3348-
{
3349-
"label": "Configuring an InterLink",
3350-
"slug": "configuring"
3321+
"label": "Configure an InterLink",
3322+
"slug": "configure-interlink"
3323+
},
3324+
{
3325+
"label": "Create a routing policy",
3326+
"slug": "create-routing-policy"
3327+
},
3328+
{
3329+
"label": "Delete an InterLink",
3330+
"slug": "delete-interlink"
3331+
}
3332+
],
3333+
"label": "How to",
3334+
"slug": "how-to"
33513335
},
33523336
{
3353-
"label": "InterLink statuses",
3354-
"slug": "statuses"
3337+
"items": [
3338+
{
3339+
"label": "InterLink API Reference",
3340+
"slug": "https://www.scaleway.com/en/developers/api/interlink/"
3341+
}
3342+
],
3343+
"label": "API/CLI",
3344+
"slug": "api-cli"
33553345
},
33563346
{
3357-
"label": "Using BGP communities",
3358-
"slug": "bgp-communities"
3347+
"items": [
3348+
{
3349+
"label": "InterLink overview",
3350+
"slug": "overview"
3351+
},
3352+
{
3353+
"label": "InterLink provisioning",
3354+
"slug": "provisioning"
3355+
},
3356+
{
3357+
"label": "Configuring an InterLink",
3358+
"slug": "configuring"
3359+
},
3360+
{
3361+
"label": "InterLink statuses",
3362+
"slug": "statuses"
3363+
},
3364+
{
3365+
"label": "Using BGP communities",
3366+
"slug": "bgp-communities"
3367+
}
3368+
],
3369+
"label": "Additional Content",
3370+
"slug": "reference-content"
33593371
}
33603372
],
3361-
"label": "Additional Content",
3362-
"slug": "reference-content"
3363-
}
3364-
],
3365-
"label": "InterLink",
3366-
"slug": "interlink"
3367-
},
3373+
"label": "InterLink",
3374+
"slug": "interlink"
3375+
},
33683376
{
33693377
"items": [
33703378
{

‎pages/apple-silicon/how-to/assets/scaleway-aps-utm-1.webp‎

172 KB
Loading

‎pages/apple-silicon/how-to/assets/scaleway-aps-utm-2.webp‎

173 KB
Loading

‎pages/apple-silicon/how-to/assets/scaleway-aps-utm-3.webp‎

198 KB
Loading

‎pages/apple-silicon/how-to/assets/scaleway-aps-utm-4.webp‎

1 MB
Loading

‎pages/apple-silicon/how-to/setup-vm-with-utm.mdx‎

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
---
2+
meta:
3+
title: How to set up a VM with UTM on a hosted Mac mini
4+
description: Learn how to create a fully independent and functional virtual machine inside a Scaleway Mac using UTM, a powerful virtualization tool for macOS.
5+
content:
6+
h1: How to set up a VM with UTM on a hosted Mac mini
7+
paragraph: Learn how to create a fully independent and functional virtual machine inside a Scaleway Mac using UTM, a powerful virtualization tool for macOS.
8+
tags: vm utm virtual-machine
9+
dates:
10+
validation: 2025-04-15
11+
posted: 2025-04-15
12+
categories:
13+
- bare-metal
14+
---
15+
16+
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.
17+
UTM is a free and open-source software that leverages Apple's Hypervisor framework and QEMU to provide virtualization capabilities.
18+
19+
<Macro id="requirements" />
20+
21+
- A Scaleway account logged into the [console](https://console.scaleway.com)
22+
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
23+
- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/)
24+
- A [Mac mini](/apple-silicon/how-to/create-mac-mini/)
25+
- [VNC access](/apple-silicon/how-to/access-remote-desktop-mac-mini/) to your Mac
26+
27+
## Installating UTM
28+
29+
1. Download and install UTM on the Mac mini:
30+
* From the official [Mac App Store](https://apps.apple.com/us/app/utm-virtual-machines/id1538878817) or
31+
* Directly from the [official website](https://getutm.app/).
32+
2. Download the macOS IPSW file.
33+
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.
34+
* Obtain the macOS IPSW file from the official [Apple Developer website](https://developer.apple.com/download/).
35+
<Message type="note">
36+
You need an [Apple Developer account](/apple-silicon/troubleshooting/cant-create-apple-account/) to access these files.
37+
</Message>
38+
3. Create a new virtual machine:
39+
* Open UTM and click the "+" button to create a new VM.
40+
* Select "Virtualize" and then "macOS".
41+
* Browse and select your downloaded IPSW file.
42+
* Configure your VM's properties:
43+
* Set your desired CPU cores (recommended at least 2 cores).
44+
* Allocate RAM (recommended at least 4 GB).
45+
<Lightbox src="scaleway-aps-utm-1.webp" size="medium" alt="The RAM allocation window of UTM with 4096 MB of RAM selected" />
46+
* Configure the disk storage size (recommended at least 64 GB).
47+
<Lightbox src="scaleway-aps-utm-2.webp" size="medium" alt="The disk size configuration window of UTM with 64 GB of storage chosen" />
48+
* Click "Save" to create the VM.
49+
<Lightbox src="scaleway-aps-utm-3.webp" size="medium" alt="Summary of the VM configuration displaying the Save button to apply the configuration" />
50+
4. Start and set up your macOS VM:
51+
* Once the VM is installed with your properties, click the "Run" button in UTM.
52+
* A GUI window will open displaying your VM.
53+
<Lightbox src="scaleway-aps-utm-4.webp" size="medium" alt="Mac OS setup wizard" />
54+
* Follow the macOS installation process:
55+
* Select language preferences.
56+
* Set up your Apple ID (optional).
57+
* Create a user account with a username and password.
58+
* Choose time zone and other basic settings.
59+
* Wait for the installation to complete.
60+
61+
## Troubleshooting
62+
### You are experiencing IPSW compatibility issues
63+
- Ensure your IPSW file is compatible with UTM by checking the following points:
64+
- The macOS version is supported by your UTM version
65+
- The IPSW architecture matches your Mac's architecture (in our case, `arm64` for Apple silicon architecture)
66+
- The IPSW file is not corrupted (verify checksums if available)
67+
- For performance issues, try adjusting the allocated CPU cores and RAM
68+
69+
## Additional tips
70+
- Take snapshots of your VM before making significant changes
71+
- Use shared folders to easily transfer files between the host and guest systems
72+
- For testing purposes, consider creating multiple VMs with different macOS versions
73+
74+
<Message type="tip">
75+
For more advanced information about UTM, refer to the [official UTM documentation](https://docs.getutm.app/)
76+
</Message>
77+
78+
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.

‎pages/apple-silicon/how-to/test-mdm-workflows.mdx‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
---
2+
meta:
3+
title: How to test MDM workflows using a VM
4+
description: This page explains how to test MDM workflows using a VM
5+
content:
6+
h1: How to test MDM workflows using a VM
7+
paragraph: This page explains how to test MDM workflows using a VM
8+
tags: vm utm mdm
9+
dates:
10+
validation: 2025-04-15
11+
posted: 2025-04-15
12+
categories:
13+
- bare-metal
14+
---
15+
16+
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.
17+
18+
This documentation guide is designed to help you get started with testing MDM automation and deployment workflows on a Scaleway Mac mini with UTM.
19+
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.
20+
21+
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.
22+
23+
<Macro id="requirements" />
24+
25+
- A Scaleway account logged into the [console](https://console.scaleway.com)
26+
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
27+
- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/)
28+
- A [Mac mini](/apple-silicon/how-to/create-mac-mini/)
29+
- [VNC access](/apple-silicon/how-to/access-remote-desktop-mac-mini/) to your Mac
30+
- [Installed](/apple-silicon/how-to/setup-vm-with-utm/) UTM and created a virtual machine (VM)
31+
- An MDM server (such as microMDM, Jamf, InTune, or other MDM provider) configured and ready for use
32+
33+
## MDM enrollment
34+
35+
1. Install and configure your MDM server according to the provider's documentation.
36+
2. Create an enrollment profile from your MDM solution.
37+
3. On your VM, navigate to **System Settings** > **General** > **Device Management**.
38+
4. Complete the enrollment process specific to your MDM provider to connect your VM to your MDM server.
39+
40+
### Testing MDM commands and deployment
41+
42+
1. Use your MDM's admin console to push configurations and commands to the enrolled VM.
43+
2. Verify that MDM commands are properly received and executed on the VM.
44+
3. Test software deployment, configuration profiles, and policies to ensure they are working as expected.
45+
4. Simulate real-world device management scenarios to ensure your MDM setup is working correctly.
46+
47+
### Manual configuration profile installation (optional)
48+
49+
If needed, you can manually install a configuration profile on your VM:
50+
51+
1. Download your configuration profile (`.mobileconfig` file) from your MDM provider.
52+
2. On your VM, go to **System Settings** > **General** > **Device Management**.
53+
3. Click the "+" button and select your profile.
54+
4. Follow the prompts to install and activate the profile.
55+
56+
By following these steps, you should be able to successfully enroll your VM in your MDM server and test MDM commands and deployment.

0 commit comments

Comments
 (0)