BetaNo feature or time limits right now.About the beta

Any OS

Virtual machine settings reference

Works onWindowsUbuntuUpdated 2026-10-17

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

ItemDescription
NameThe name shown in the list. 1–80 characters.
NotesNotes about this virtual machine. Up to 2,000 characters.
When the window is closedAsk every time (default) / Suspend virtual machine / Shut down virtual machine / Keep running in background. Start and stop
Keyboard profilePick which profile made under app settings › Keyboard this virtual machine uses.
Virtual machine infoShows the operating system, identifier, and creation date. Open Folder opens the virtual machine folder in Finder.
Windows installation passwordWindows 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 machineType 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

ItemDescription
CPUThe number of cores to give the virtual machine. Leave some for Mac tasks (maximum = the Mac's core count − 2).
MemoryThe memory to give the virtual machine. Leaves 25% for the Mac (maximum = 75% of the Mac's memory).
Apply recommended settingsSwitches to values recommended for this Mac.
Hard diskCan 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 suspendingThe saved file gets smaller and suspending can be faster, but resuming takes about a second longer.
Firmware › Use Secure BootWindows 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

ItemOptionsApplies
ResolutionAdjust automatically to the window size / Keep the virtual machine's resolutionImmediately
Display modeKeep aspect ratio / Stretch to FitImmediately
Use All Displays in Full ScreenUse all displaysNext 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

ItemDescription
Enable sound outputPlays 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 MacKeeps the Mac's and the virtual machine's volume and mute in sync. Can be changed while running.
Share the Mac microphoneLets 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 cameraLets apps in the virtual machine use the Mac camera. macOS asks for permission when the camera is turned on.

Network

ItemDescription
Connection typeShared (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 bridgeThe Wi-Fi or wired interface to use when bridged
Network adaptervirtio-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 rulesUse Add rule to set the protocol (TCP · UDP), Mac port, and virtual machine port. Applies from the next start.
MAC addressIt'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.

Was this article helpful?

Still stuck?

Search the Help Center by symptom or contact our support team.

Help Center