MacVisor

The MacVisor interface

The main window, VM windows, Settings and menus, and where to find things.

MacVisor has a main window for your library, and a window for each VM's display. VMs run in a background service, so closing a window leaves its VM running, unless When the Window Closes in VM Settings → General says otherwise.

The MacVisor window: VM list in the sidebar, a running Ubuntu VM's Overview tab, and the task pane.

The main window has three parts:

  • The sidebar, on the left: your VMs, templates, storage and networks.
  • The detail pane: the selected VM's tabs, or the dashboard when nothing is selected.
  • The task pane, at the bottom: downloads, installs and other long jobs.

At the top is this Mac: its name, with its IPv4 address under it. Its tooltip has the kind of Mac, its chip and memory, and macOS, and a click shows the dashboard. The control under it switches between four sections, each with its own search and, except in Storage, a + button. The sidebar's toolbar has Refresh and Settings (the gear).

SectionShows+ adds
Virtual MachinesEvery VM and its state. Double-click a running VM to open its window.A VM
TemplatesCloud images, macOS installers, and your templates. You can also drop a qcow2, raw, .xz, .gz or .ipsw file here.An image or installer file
StorageStorage locations and what's in them. A location that's unmounted or not yet readable shows a button to fix it.A location, from Add Location… at the end of the list
NetworksHost interfaces, VLAN interfaces and custom networksA network or VLAN interface

A VM's row shows AUTO when it starts at login and HA when High Availability is on.

A VM you're creating is in the list from the moment you click Create, with a progress circle and what it's waiting on, such as "Downloading the macOS Golden Gate 27.2 installer · 34%". Select it for its progress and Cancel. See While a VM is being made.

Several at once. Command-click or Shift-click to select several VMs, or several templates (⌘A selects all). Control-click the selection for Start, Resume, Suspend, Shut Down, Power Off or Move to Trash… (templates have only Move to Trash…). Each acts only on the selected VMs it applies to: Start skips running and suspended VMs, for example. Moving running VMs to the Trash turns them off first, and a VM or template that other VMs are made from stays unless those VMs are selected too.

Dashboard

With no VM selected, or after a click on the Mac at the top of the sidebar, the dashboard shows the Mac. Under its name is a line such as "Mac mini M4 Pro 64 GB RAM · macOS 27.2.1 (26B131) · up 3d 4h". Below are live CPU, memory, GPU and storage, the resources given to running VMs (overcommitting is flagged, not blocked), an inventory, the VMs that start at login, and the background service's health, with buttons to restart it or open its logs. While you have no VMs, it starts with Get Started: Create Your First VM…, Import VMs…, Take the Tour and, until setup is done, Finish Setting Up MacVisor….

The dashboard: the background service, resources given to running VMs, an inventory, live readings for the Mac, and Unattended Auto-Start.

VM tabs

A selected VM has three tabs: Overview, Snapshots and Settings. Templates have only the last two.

  • Overview shows the VM at a glance. See below.
  • Snapshots takes, reverts, clones from and deletes snapshots, and Delete All Agent Checkpoints… removes the checkpoints AI agents took. Snapshots stay inside the VM; for copies elsewhere, see Backups.
  • Settings is the VM settings reference.

The Overview tab

The VM's card (macOS VM, Linux VM, Windows VM, FreeBSD VM or Appliance) says how to get in:

  • mvz shell with its command, and Open in Terminal, for a VM set up with SSH.
  • Open in Windows App for a Windows VM.
  • The account's password, with Show Password, Copy Password, Delete Password… and, while the VM runs with a window, Type Password. macOS VMs with automatic setup, Windows, Ubuntu Desktop and FreeBSD VMs have one. Show, Copy and Type Password ask for Touch ID or your Mac's password first; one confirmation lasts five minutes for that VM.
  • How setup went, its account and shares, for a Linux VM made from a cloud image.

The other cards:

CardShows
DisplayA live preview. Double-click it to open the VM's window.
Guest ToolsWhether the MacVisor Agent is connected, what it reports (system, hostname, kernel), and the Clipboard setting. Each status is explained in Guest tools.
NetworkEach adapter by the network it's on, with its mode, MAC address and IP addresses, then other guest interfaces such as docker0. An adapter whose custom network was deleted shows Network missing.
CPU, Memory, GPU, Storage, network trafficThe VM's size while it's stopped, and live use while it runs, with Runner Log. See The Memory card.
Snapshots, NotesThe VM's snapshots, with Take Snapshot…, and its notes
Memory Balloon, Port Forwarding, USB DevicesThe balloon's size, the VM's port forwards, and, while it runs, the state of each USB device it remembers
USB Mass StorageDisk images attached while the VM runs, with Attach Disk Image…
AI sandbox, High AvailabilityFor an AI sandbox, and when High Availability has something to report

The Memory card

While a VM runs, the Memory card shows what the guest itself uses, as the MacVisor Agent reports it, and the guest's memory pressure: Normal, Warning or Critical, in green, yellow or red. Below that is what the VM holds on this Mac, which is normally its whole memory or a little more. That's not a sign of trouble: only the guest's pressure colours the bar. See Memory reporting for the details.

Notes

A new VM's notes start with one line saying what it was made from, its system where MacVisor knows it, and when:

Created using the cloud image "Ubuntu 26.04 LTS" (Ubuntu 26.04 LTS) on 7 Nov 2026.

A linked clone says so, and a VM installed from an ISO names the file. A copy, a linked clone, or a VM made from a template or snapshot keeps its source's notes below its own line. It's ordinary text: edit or delete it in VM Settings → General.

Task pane

Downloads, installs, transfers, snapshots, backups and disk conversions run as tasks in the pane at the bottom of the window, each with its progress and what started it: the app, mvz or a VM. Cancel one with ⓧ at the end of its row (cancelling an install asks first). Finished tasks move to Task History.

Tasks run in the background service, so they continue after you quit the app. mvz tasks lists the running tasks and the last ten that finished.

VM windows

Double-click a running VM, or choose Open Window, to see its display. Each VM window has its own Dock icon with the VM's name under it (pointing at it shows MacVisor VM, the app that runs VM windows), and appears in Activity Monitor and Force Quit under the VM's name.

Its VM menu has Pause, Receive Files, Type Password and Type Clipboard (see Type Password and Type Clipboard), Attach Guest Tools or Eject Guest Tools, Attach Disk Image… and Eject (see Disk images on a running VM), Shut Down, Restart and Power Off.

The toolbar's USB button passes a USB device plugged into the Mac through to the VM. See USB devices.

A VM with a serial console has View → Show Console and Show Display (⌃⌘C), and a Linux or FreeBSD VM's toolbar has a Display | Console switch for the same.

Settings

Open Settings with ⌘, or the gear in the sidebar.

TabWhat's there
GeneralOpen Setup Assistant…; Show the welcome and What's New, whether they open by themselves on a first launch and after an update; Logout and Shutdown, what running VMs do when you log out or shut down the Mac (see Run and control VMs); Open shells in, the terminal app for Open in Terminal and AI sandbox shells (Terminal, iTerm2, Ghostty, Warp, WezTerm, Alacritty, kitty, or any app); text size; the menu bar item; and Logs → Log Detail, how much the app, service and VM logs keep (Trace, Debug, Info, Warning or Error; Debug by default; mvz service log-level)
VMsEvery VM, with its Auto-start and High Availability switches, the same as in VM Settings → General
RegistriesSign-ins for registry images
AIThe gateway, local model servers and API keys for AI sandboxes, and Agent Access: which folders agents may make sandboxes from, whether their sandboxes get open internet access, and Connect Agents (see Connect an agent)
LicenseThe trial, activation, Refresh License and Move to This Mac. See Activate your license.
UpdatesUpdate checks, and Download and install updates automatically (on by default): an update installs when you quit MacVisor, or while it's closed

Show MacVisor in the Menu Bar, in General, lets you control every VM from the menu bar, handy on a headless host. With it on, MacVisor opens at login without its main window.

MenuItems
FileNew VM… (⌘N), New VM from Disk Image…, Import… (⇧⌘I), New AI Sandbox…
Virtual MachineFor the VM selected in the list: Start, Shut Down, Restart, Power Off, Pause, Suspend, Resume, Open Window, Take Snapshot…, Clone…, Move to Trash… (also Delete or ⌘⌫ in the list), and Erase and Install macOS… or Erase and Install Windows… for a VM whose install failed. See Run and control VMs for shortcuts.
LogsService Log, App Log, Runner Logs, Report a Problem…
AssistantSetup Assistant…, Task History, Restart Background Service, Uninstall MacVisor…
HelpMacVisor Help, What's New in MacVisor, Welcome to MacVisor, Email Support…, Report a Problem…, Join r/macvisor on Reddit, Report an Issue or Request a Feature on GitHub, License Agreement

Report a Problem… collects the logs, crash reports, the end of each VM's console log and a summary of your setup into a zip for support. See Sending us a problem report.