MacVisor

Activate your license

How the free 30-day trial starts, activating a key, license checks and offline use, one license for every account on a Mac, and moving a license between Macs.

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 TrialMacVisor 27 ProMacVisor BusinessEnterprise
Macs1, once per Mac1 or 2 per license3 or more, on one keyAs many as you need
Term30 days from when you start itOne-time, covers MacVisor 27.xYearly, renews; new major versions includedPer your agreement, renews
How to get itStarts when you accept the License Agreement, or mvz license trialBuy MacVisorBuy BusinessEmail sales
Shown in the app asTrialMacVisor 27 ProMacVisor Commercial LicenseMacVisor 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

  1. Open Settings → License, or the License item of the Setup Assistant.
  2. Paste the key from your email.
  3. 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

WhenWhat happens
MacVisor starts the trial, or you run mvz license trial, activate, refresh, deactivate, or move a licenseOne request to the licensing server
The trial is being started and gets no answerAgain after about 30 seconds, 2 and 10 minutes, then every 30 minutes, until it starts
Every few daysA background check, whether or not the app is open. A Mac that was offline checks soon after it's back online
After MacVisor updatesA check, by the new version
After a license or trial endsA check for a renewal. A renewed subscription continues.
After a check gets no answerRetried 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 seeWhat to do
The key is refusedCopy the whole key with no extra spaces. Check that it starts with MVZ-.
Trial endedBuy 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 MacDeactivate 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 verificationThe Mac hasn't reached the licensing server in 30 days. Connect and click Refresh License, or run mvz license refresh.
Confirming licenseMacVisor 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 againThe 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 licenseSee The library or CLI cannot reach the service.
Reinstall MacVisorThis 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.