Virtual machine settings reference
In short
Every tab and item in the virtual machine settings you open from Settings on a VM card. You can change the name, notes, display mode, volume sync, network connection type, and keyboard profile while it's running. change hardware after shutting the virtual machine down.
General
| Item | Description |
|---|---|
Name | The name shown in the list. 1–80 characters. |
Notes | Notes about this virtual machine. Up to 2,000 characters. |
When the window is closed | Ask every time (default) / Suspend virtual machine / Shut down virtual machine / Keep running in background. Start and stop |
Keyboard profile | Pick which profile made under app settings › Keyboard this virtual machine uses. |
Virtual machine info | Shows the operating system, identifier, and creation date. Open Folder opens the virtual machine folder in Finder. |
Windows installation password | Windows only. See the user password saved during installation with Show password and Copy password. It isn't updated if you change it in Windows. |
Delete virtual machine | Type Delete now in the field and click Delete this virtual machine to erase the disk, checkpoints, saved state, and logs. A running virtual machine can't be deleted. |
Hardware
| Item | Description |
|---|---|
CPU | The number of cores to give the virtual machine. Leave some for Mac tasks (maximum = the Mac's core count − 2). |
Memory | The memory to give the virtual machine. Leaves 25% for the Mac (maximum = 75% of the Mac's memory). |
Apply recommended settings | Switches to values recommended for this Mac. |
Hard disk | Can only be increased (up to 512 GB, within the Mac's free space). It only takes up as much Mac space as actually used. After enlarging it, you'll need to extend the partition inside the virtual machine to see the extra space. |
Compress memory when suspending | The saved file gets smaller and suspending can be faster, but resuming takes about a second longer. |
Firmware › Use Secure Boot | Windows only. Turning it off lets you load a driver you built yourself. Leave it on for everyday use. |
See CPU, memory, and disk for detailed recommendations. Applies from the next start.
Display
| Item | Options | Applies |
|---|---|---|
Resolution | Adjust automatically to the window size / Keep the virtual machine's resolution | Immediately |
Display mode | Keep aspect ratio / Stretch to Fit | Immediately |
Use All Displays in Full Screen | Use all displays | Next start |
Startup resolution (Windows) | Match Mac Display (default), a list including 1920 × 1080 and 4K UHD (3840 × 2160), or a custom entry (width 640–4096 · height 480–4096). A chosen size limits automatic resolution. | Next start |
Refresh rate (Windows) | 60 Hz / Same as the Mac display (follows the display the window is on, up to 120 Hz) | Next start |
Ubuntu always has OpenGL/Vulkan acceleration on, so there's nothing to choose here. You can also change display options from the View menu in the VM window. See Display and graphics for details.
Sound & Camera
| Item | Description |
|---|---|
Enable sound output | Plays the virtual machine's sound through the Mac's default output device, and follows along if you change it on the Mac. Can't be changed while running. |
Sync volume with the Mac | Keeps the Mac's and the virtual machine's volume and mute in sync. Can be changed while running. |
Share the Mac microphone | Lets apps in the virtual machine record with the Mac microphone. macOS asks for permission the first time an app records. Pick which microphone to use from the VM window's Microphone menu. |
Share the Mac camera | Lets apps in the virtual machine use the Mac camera. macOS asks for permission when the camera is turned on. |
Network
| Item | Description |
|---|---|
Connection type | Shared (NAT) / Bridged / Shared with the Mac only. It changes right away even while running, and the connection drops for a few seconds while it gets a new address. |
Mac interface to bridge | The Wi-Fi or wired interface to use when bridged |
Network adapter | virtio-net (recommended · ARM64 driver) |
Use SSH port forwarding · Mac port (127.0.0.1) | Shared (NAT) only. Mac's 127.0.0.1:port → virtual machine's port 22 (1024–65535) |
Port forwarding rules | Use Add rule to set the protocol (TCP · UDP), Mac port, and virtual machine port. Applies from the next start. |
MAC address | It's fixed for each virtual machine, so the router always hands out the same IP. |
See Networking for details.
Sharing
Add up to 16 with Add Folder… and Share Home Folder, and set a share name and Read-only per folder. Remove stops sharing. Applies from the next start. See Shared folders for details.
CD/DVD
Attach an install image (ISO) with Choose image… and detach it with Eject. While an image is attached, the boot menu opens on start; with none attached, it boots straight from disk. Ubuntu's autoinstall media can't be ejected or changed.
Checkpoints
Save checkpoints, restore them as new VMs, and delete them. Changes apply right away. See Checkpoints.
AI Agents
Set the permission level, which agents to allow, risky actions, the agent folder, and the activity log. Changes apply right away. See AI agents.
Still stuck?
Search the Help Center by symptom or contact our support team.