How to Guide for Mavericks VM on Mavericks

Richard —  July 16, 2014 — 15 Comments

Installing Mavericks inside a virtual machine is fairly easy, but there are a few tricks to be aware of if you’re on a newer Mac. Credit to Natsuki’s post for sharing how to get the Mavericks installer to run on Apple computers with Intel Haswell CPU’s. Natsuki also notes a workaround for Apple computers with ECC RAM that requires the removal of a kernel module from the install image using iesd.

Download and install the latest VirtualBox for OS X hosts from here. We’ll be using VirtualBox so that anybody can follow these steps.

Download the Mavericks Installer App through the App Store.The Mavericks installer is provided for free by Apple for users to upgrade their computers to the latest version of OS X. We’ll be making use of the install image provided by this application to install Mavericks within a virtual machine.

While we’re waiting for the Mavericks Installer to download, lets get started on configuring our new Virtual Machine.

Create a New Virtual Machine


Lets call it “Mavericks”


Lets allocate 2 GB of my host machine’s 8 GB of RAM


Lets create a new blank disk image for this machine


The VDI format should be fine for what we’re doing


A dynamically sized disk should also be fine for what we’re doing


Lets call this disk image “Mavericks” too


And we’re successfully created our virtual machine


We need to check if your computer has an Intel Haswell processor. We’re going to use “About This Mac” to check.

Lets launch “About This Mac”


Click on “More Info…”


If you see “Late 2013” or later, we’ll need to change the CPUID for our virtual machine so the installer image boots


We need to determine the name of the virtual machine, if you called it something other than “Mavericks” you’ll need to use the name you get from this command:
VBoxManage list vms


Now that we have the name, we can specify the CPUID for that virtual machine

Run VBoxManage modifyvm Mavericks --cpuidset 00000001 000306a9 00020800 80000201 178bfbff (Substitue Mavericks with what you got from VBoxManage list vms if you have something different)


In your terminal, run sudo gem install iesd

iesd is a Ruby applicaiton with extracts the installer disk image from the installer application to for use as a boot disk for your virtualization software.

Gem Install

Run iesd -i /Applications/Install\ OS\ X\ -o Mavericks.dmg -t BaseSystem


Now you’ll have a Mavericks.dmg inside your user’s home folder.

Now we’ll attach this disk image to our virtual machine

Click on the “Storage” text of this new machine


Click on the “Empty” list item


Click on the CD icon to “Choose A Virtual CD/DVD Disk File…”


Choose the Mavericks.dmg file that iesd produced in your home folder

missing image

Now we’re set to install Mavericks within the VM!


Wait for the VM to boot. You’ll see plenty of black on white text scroll by with some errors and warnings, but they are acceptable.


And we’ve booted!


The mouse will be very laggy on this screen because of the animation, so it may be easier to hit the “Enter” key than to navigate to the next button with the mouse.

Before continuing with the installer, we need to format the blank disk so that the installer detects it as an install location.

Go to “Utilities” -> “Disk Utility…” to launch the Disk Utility


Select the “VBOX” disk and go to the “Erase” tab. Give the disk a better name than “Untitled”, I’m partial to “Mavericks” and then click “Erase”


Click “Erase” again when prompted


Wait for the disk to be erased. Once it’s ready, the named disk will appear in the top left of Disk Utility.


Quit Disk Utility


Now we’re all set to install Mavericks!

Click “Continue” on the Installer


Agree to the EULA and note the section that permits what we are doing


Select the volume we created with Disk Utility and click Install


It will take a little over 20 minutes for the installer to run




We’ve successfully installed Mavericks. Lets take a snapshot of the machine at this point in case we ever want to reset back to the big bang.

After the Machine restarts, we’re actually going to want to “Power off the machine” so that we can take a snapshot of the virtual disk and detach the install disk


On VirtualBox Manager, click on “Snapshots” for this machine


Click the Camera icon to take a snapshot


Name your snapshot


Snapshot created


Lets not forget to detach the the installer image.

Switch back to the “Details” pane and click on the “Storage” text


Click on the installer image, then the CD icon, and finally “Remove disk from virtual drive”


From here, you’re good to go to start the virtual machine again and continue with the installer. I’d recommend taking another snapshot after you’ve set up the virtual machine so that you have another checkpoint to restore to.

A couple caveats here and also here (under “Mac OS X guests”). There aren’t any Virtualbox Guest Additions for OS X and the default resolution of the machine is 1024×768.

From the VirtualBox documentation, it is possible to set higher resolutions with VBoxManage setextradata "VM name" VBoxInternal2/EfiGopMode N where N values of 0-5 correspond with 0=640×480, 1=800×600, 2=1024×768, 3=1280×1024, 4=1440×900, 5=1920×1200

Thanks for sticking through this how-to. I hope that this VM image will be useful in testing your OS X applications. Don’t forget to make liberal use of snapshots; and remember that you can create lightweight, snapshot-based clones of this VM if you need more than one.

You should join me in the comments for discussion of this how-to.



Richard Brooks is a Quality Assurance Engineer of Consumer Electronics at BitTorrent. His second desk is the Adams Family pinball machine in the game room.