Thanks for choosing MacVisor. The free trial starts when you accept MacVisor's License Agreement, with no key and no checkout. A license you buy arrives by email from Polar, our store, as a key that starts with MVZ-. You activate it in the app or with mvz license.
MacVisor checks trials and licenses with ScaleNinja's licensing server, keys.scaleninja.com. Polar handles checkout, receipts, refunds and renewals, and lists your orders in its customer portal.
| Free Trial | MacVisor 27 Pro | MacVisor Business | Enterprise | |
|---|---|---|---|---|
| Macs | 1, once per Mac | 1 or 2 per license | 3 or more, on one key | As many as you need |
| Term | 30 days from when you start it | One-time, covers MacVisor 27.x | Yearly, renews; new major versions included | Per your agreement, renews |
| How to get it | Starts when you accept the License Agreement, or mvz license trial | Buy MacVisor | Buy Business | Email sales |
| Shown in the app as | Trial | MacVisor 27 Pro | MacVisor Commercial License | MacVisor Commercial License |
Business and Enterprise licenses show as MacVisor Commercial License. Settings → License shows how many Macs a license covers. Prices are on Pricing and licensing.
A trial or license is only needed to add to your library: creating, cloning and importing VMs, downloading cloud images and macOS installers, and pulling and pushing registry images. Your VMs keep working when a trial or license ends, and restoring one of MacVisor's backups needs neither, though once it has ended, a restored VM starts only if this Mac had it and it's gone (below).
A VM added to your library after the trial or license ended doesn't start until you activate a key: a VM package copied or moved into a storage location, such as a copy of a VM, an export or an exported snapshot, a backup restored as a second copy beside the VM it was taken from, or a backup of a VM from another Mac. Its row reads Needs a license, and starting it, in the app, with mvz or by an agent, says how to license MacVisor. Restoring a backup in place of a VM that's no longer in your library works as before, and the VM starts. MacVisor's Network Helper keeps the list of the VMs this Mac had while it was licensed or in its trial, as their ids only, in a file only root can change, which uninstalling MacVisor keeps.
Start the free trial
MacVisor starts the trial by itself when you accept its License Agreement, the first page it shows, on a Mac with neither a license nor a trial. The agreement page says so under Agree & Continue, with what starting it sends. On a Mac that accepted the agreement with an earlier MacVisor and has neither, it starts the first time 27.2.1 or later opens.
It starts in the background, and setup goes on meanwhile. The License row of the Setup Assistant, Settings → License, the sidebar badge and the menu bar menu say Starting your free trial…, then show the days left. While MacVisor waits to be allowed in the background, the trial starts as soon as you switch MacVisor on in Login Items.
Starting it needs the internet once. If a try doesn't start it (offline, say), the License row and Settings → License say Trial not started yet and why, with Try Again. MacVisor also tries again by itself: after about 30 seconds, 2 minutes and 10 minutes, then every 30 minutes, and when you switch to MacVisor, at most once a minute. Until it starts, adding VMs waits, as without a license. Your VMs keep running.
On a Mac you reach only over SSH, which never shows the agreement, run:
mvz license trial
The trial has every feature and lasts 30 days. No sign-up or email is needed. Until you activate a license, a card over the main window shows each time the window opens: while the trial starts, during it and after it ends. It suggests things to try and links to these docs. Continue waits five seconds, except once the trial has ended. During the trial and after it, the sidebar badge has Buy License, which opens the page where you buy MacVisor.
There is one trial per Mac. Reinstalling MacVisor or using another account doesn't start a new one: a Mac whose trial was used gets it back as it was, ended or not. If you bought a Mac whose trial someone else used, contact support and we'll reset it. Each network can start a few trials a day; if your organization is evaluating MacVisor on many Macs behind one address, ask support to raise the limit.
After you deactivate the license, move it to another Mac or remove the trial, no trial starts in the same session. At the next launch MacVisor starts the trial, or brings back the one this Mac had. Until then, Start Free Trial in Settings → License starts it.
When the trial ends, the sidebar badge reads Trial ended, with Buy License beside it. Creating, cloning and importing VMs pause until you activate a key, and so does starting a VM added after the trial ended. The VMs you had keep working.
Activate a license key
- Open Settings → License, or the License item of the Setup Assistant.
- Paste the key from your email.
- Click Activate.
The License tab then shows the edition, the masked key, and when it was last checked. A key you enter before MacVisor is allowed in the background is kept, and activates as soon as it is.
Upgrading from the trial. During a trial, the key field stays in Settings → License under Upgrade from the Trial. Entering a key there replaces the trial. You don't need to end the trial first.
From the command line
mvz can license a Mac you only reach over SSH:
mvz license # show this Mac's license
mvz license trial # start the free trial
mvz license activate # prompts for the key
echo "$KEY" | mvz license activate - # reads the key from standard input
mvz license activate MVZ-... --move # move a key that's active on another Mac to this one
mvz license refresh # check with the licensing server now
mvz license deactivate # release this Mac (asks first; --yes skips the question)
mvz license activate only prompts in an interactive terminal. Over SSH, use ssh -t or pipe the key in with -. Passing the key as an argument works too, but it ends up in your shell history. Add --json to any of these for machine-readable output.
The app and mvz show the same license. On an unlicensed Mac, create, clone, import, images pull and images add fail with a message saying how to activate, and so does starting a VM added after the trial or license ended. Everything else works.
The background service runs only while you're logged in. A Mac you reach only over SSH needs automatic login, plus one session at the screen or over Screen Sharing for first-run setup.
Licenses on a Mac with several accounts
One license covers every macOS account on the Mac. The Network Helper, which you approve once in Login Items, holds it for the whole Mac, so other accounts are licensed automatically when they open MacVisor.
If the Network Helper has never been turned on, each account activates separately with the same key. This still counts as one Mac.
Once the helper holds the license, it keeps it. If the helper is off or hasn't started yet, the badge reads Licensed, checking… while the license it last held still covers the Mac: the Mac stays licensed on that answer for up to three days, never past the license's own 30-day offline allowance, and Settings → License and mvz license status say until when. That answer has to be recent: on a Mac that hasn't reached the licensing server for about six days, it carries nothing. After that, or if the helper never answered with a license, the badge reads Checking license… and adding VMs pauses until it answers. Your VMs keep running either way. Right after login this can take a minute or two. If it lasts longer, turn MacVisor on in System Settings → General → Login Items & Extensions, or open Assistant → Setup Assistant….
Any account can start the trial or activate a key. Only an administrator, or the account that activated MacVisor, can deactivate it, because deactivating affects every account. Remove Trial from This Mac… follows the same rule. It doesn't reset the trial: at the next launch MacVisor brings back the same trial, with its original dates.
License checks and offline use
| When | What happens |
|---|---|
MacVisor starts the trial, or you run mvz license trial, activate, refresh, deactivate, or move a license | One request to the licensing server |
| The trial is being started and gets no answer | Again after about 30 seconds, 2 and 10 minutes, then every 30 minutes, until it starts |
| Every few days | A background check, whether or not the app is open. A Mac that was offline checks soon after it's back online |
| After MacVisor updates | A check, by the new version |
| After a license or trial ends | A check for a renewal. A renewed subscription continues. |
| After a check gets no answer | Retried after 5 minutes, then every 15 minutes |
A Mac that can't reach the licensing server keeps working for 30 days after its last successful check. After that, adding VMs and downloading images pause, and the badge reads License needs verification. Connect and click Refresh License, or run mvz license refresh. Existing VMs keep running throughout.
The checks go to keys.scaleninja.com on port 443. Allow it if the Mac is behind an outbound firewall.
What the checks send: SHA-256 hashes of the Mac's hardware UUID and serial number, each with a MacVisor-specific prefix (never the raw values), the Mac's model (never its computer name), its chip and memory size, the MacVisor and macOS versions and the macOS build, a one-time value the signed reply must echo, and the key when you activate, refresh or deactivate. With the Network Helper on, they also send the public half of a device key that proves later checks come from the same Mac. They never send your email or anything about your VMs. Polar receives nothing from MacVisor; to check a key, the licensing server sends Polar only the key. See the privacy policy.
A logic-board replacement keeps the license, because the licensing server recognizes the Mac's serial number with the key.
Where the license is kept
With the Network Helper on, the license for the whole Mac is in /Library/Application Support/MacVisor/Licensing, readable only by root. Without the helper, each account keeps its own in ~/Library/Application Support/MacVisor/Licensing.
The licensing server signs its replies, and MacVisor verifies the signature on the Mac. A license record copied from another Mac, or edited, doesn't verify. When that happens, MacVisor confirms the license with the server instead of locking you out, and the badge reads Confirming license. Setting the clock back doesn't extend anything: licensing uses the latest date the Mac has seen.
Moving a license to another Mac
When a license is in use on all the Macs it covers, you can move it in two ways:
- Deactivate on the old Mac first. On the old Mac, click Deactivate on This Mac… in Settings → License, or run
mvz license deactivate. Then activate the key on the new Mac. This never counts against any limit. - Move to This Mac. Activate the key on the new Mac. MacVisor says the key is active on another Mac and offers Move to This Mac (or run
mvz license activate <key> --move). Use this when the old Mac is broken, lost, erased or out of reach. If the key is on several Macs, the move takes it from the one that checked in least recently. The old Mac stops being licensed at its next check, or at most 30 days after its last check if it stays offline.
You can make up to 3 moves in 30 days from new Macs. Deactivating on the old Mac first doesn't count.
A Mac holds one key at a time. A paid key replaces a trial directly, but to switch to a different paid key, deactivate the current one first.
If the old Mac is offline when you deactivate, the License tab shows Deactivating and adding VMs pauses. MacVisor releases the Mac the next time it reaches the licensing server.
If you activated during the beta
Earlier betas activated keys through Polar. The first time an updated MacVisor reaches the licensing server, it moves your license over by itself. There's nothing to re-enter.
If the beta had a free-trial key, or a key the licensing server doesn't recognize, MacVisor starts the Mac's free trial instead. Beta trial keys don't carry over. Until MacVisor has reached the licensing server once, adding VMs waits. Existing VMs keep running.
If something goes wrong
| What you see | What to do |
|---|---|
| The key is refused | Copy the whole key with no extra spaces. Check that it starts with MVZ-. |
| Trial ended | Buy a license and enter the key in Settings → License. |
| The trial won't start (Trial not started yet) | It needs the internet once. MacVisor keeps trying, and Try Again in Settings → License tries now. If too many trials were started from your network today, try tomorrow or contact support. If it says this Mac's trial has ended and you never used it, contact support. |
| The key is active on another Mac | Deactivate it there, or click Move to This Mac. See Moving a license to another Mac. |
| "This license key is no longer valid (refunded or revoked)" or "This license key has been disabled." | The key was refunded, revoked or disabled. Buy a license, or contact us if that's wrong. |
| "This license was moved to another Mac." | Someone moved this key to another Mac. Activate it here again, with Move to This Mac if needed. |
| "This license isn't activated on this Mac." | The license record came from another Mac, often through Migration Assistant. Activate the key again here. |
| License needs verification | The Mac hasn't reached the licensing server in 30 days. Connect and click Refresh License, or run mvz license refresh. |
| Confirming license | MacVisor couldn't verify the license record on this Mac and is checking with the server. Connect and click Refresh License. It also retries by itself. |
| Activate again | The license record couldn't be read. Enter your key again. Activating again on the same Mac doesn't use another seat. |
| Licensed, checking… or Checking license… | The Network Helper hasn't answered yet. With Licensed, checking… the Mac is still licensed on the helper's last answer, for up to three days, and Settings → License says until when; with Checking license… adding VMs waits. Wait a minute or two after login. If it persists, turn MacVisor on in Login Items. See Licenses on a Mac with several accounts. |
| The License tab says the service hasn't reported the license | See The library or CLI cannot reach the service. |
| Reinstall MacVisor | This copy of MacVisor is damaged or modified, so it can't be licensed. Download it again from the product page and reinstall. Your key and VMs are unaffected. |
| "The licensing server's reply couldn't be read" or "...couldn't be verified" | The reply was in a format this version can't read, or a proxy changed it. Nothing on the Mac changed. Check for a MacVisor update, and contact us if it keeps happening. |
More in Troubleshooting. Terms are in Pricing and licensing.
DeltaSync