Phiplex / runMacOSinVirtualBox

Run macOS 10.14 Mojave (and other versions) in VirtualBox on macOS

Run macOS 10.14 Mojave (and other versions) in VirtualBox on macOS

Overview

Simple script to automatically download, install and run macOS 10.14 Mojave (and other versions) in VirtualBox on macOS. Since VirtualBox does not support booting from APFS volumes, this script is copying the APFS EFI drivers automatically.

ToC

• Quick Guide
• Step by Step Guide
• Shell Hacker
• FAQ

Required Software

The following software is needed.

• macOS Installer
• VirtualBox
• VirtualBox Extension Pack (note: released under the Personal Use and Evaluation License)
• Paragon VMDK Mounter (note: discontinued, but still available)

Step by Step Video

Two minute summary video:

Step by Step

Execute make all to setup and run everything. After the installer reboots, press enter in the terminal to finish the installation.

$ make all
Running checks (around 1 second)....
Creating image '/Users/awi/VirtualBox VMs/macOS-Mojave.dmg' (around 20 seconds, version 14.2.2, will need sudo)....
Creating iso '/Users/awi/VirtualBox VMs/macOS-Mojave.iso.cdr' (around 25 seconds)....
Creating VM HDD '/Users/awi/VirtualBox VMs/macOS-Mojave/macOS-Mojave.vdi' (around 5 seconds)....
Creating VM 'macOS-Mojave' (around 2 seconds)....
Adding APFS drivers to EFI in '/Users/awi/VirtualBox VMs/macOS-Mojave/macOS-Mojave.vdi' (around 5 seconds)....
Starting VM 'macOS-Mojave' (3 minutes in the VM)....
Press enter to stop VM 'macOS-Mojave' (e.g. after installer restarted)....

Ejecting installer DVD for VM 'macOS-Mojave'....
Starting VM 'macOS-Mojave' (3 minutes in the VM)....

Customizing your build

Additionally the following parameters can be customized with environment variables:

variable name	description	default value
VM_NAME	name of the virtual machine	macOS-Mojave
VM_DIR	directory, where the virtual machine will be stored	HOME/VirtualBox VMs/$VM_NAME
VM_SIZE	the size of the hard disk	32768
VM_RES	monitor resolution	1680x1050
VM_RAM	ram size in megabytes	4096
VM_VRAM	video ram size in megabytes	128
VM_CPU	number of cpu cores to allocate	2

Execute make to get some help:

$ make
Some available commands:
 * all      : run everything needed (check, installer, vm, patch, run, stop, eject)
 * check    : check environment
 * installer: create macOS installer image
 * clover   : create clover boot image
 * patch    : add APFS drivers to VM EFI to boot w/o clover
 * vm       : create VM and disk
 * run      : run VM
 * stop     : stop VM
 * wait     : wait for VM to stop
 * eject    : eject installer medium
 * clean    : delete generated images and downloaded files
 * stash    : delete generated VM and disk
 * test     : test shell scripts
 * style    : style shell scripts
 * harden   : harden shell scripts
 * release  : make new release
 * feedback : create a GitHub issue

FAQ

• Error Message
  • Q: I get the error code 2, 3, 4, or 6.
  • A: You need to have some software components installed on your machine (VirtualBox, VirtualBox Extension Pack, awk). If you've installed http://brew.sh, the script will partly install these automatically. Otherwise, you need to install them manually.
• Reboot
  • Q: I see the message MACH Reboot. What should I do?
  • A: The VM failed to restart. Restart manually.
• Installation Loop
  • Q: After starting the installation the VM restarts and I see the installer again.
  • A: You've to press enter in the terminal after the installer restarts.
• Kernel Panic
  • Q: I see the message Error loading kernel cache (0x9). What should I do?
  • A: This error is shown from time to time. Restart the VM.
• Black Screen
  • Q: When I then boot I don't see anything, just a black screen. What should I do?
  • A: Change the VM version in the settings from Mac OS X (64-bit) to macOS 10.13 High Sierra (64-bit)
• Other Issue
  • Q: Something is not working. What should I do?
  • A: Create a ticket