Windows Virtual Machine Setup
Set up the Virtual Machine in VirtualBox
Download and install VirtualBox
A “no root access” error may appear during installation. Ignore it for now.
Download the Windows virtual machine image
And unzip the downloaded file
Open the VirtualBox app, and use go to File → Import Appliance… to install the virtual machine
.ovffile from the downloaded VM
Continue and use all the default settings
If you start the virtual machine now you will see another nasty root access error. To fix this you need to go to:
- System Preferences → Security & Privacy
- Click the lock icon in the bottom left to unlock. Make sure your PIV is inserted.
- Select Accessibility and click on the plus
- Add VirtualBox (it should be in your
/Applicationsfolder), and make sure the box is checked
- Close System Preferences
Start the virtual machine in VirtualBox (Start → Normal Start)
Log in to the virtual machine
The password is
Configuring applications for local development
In a Windows virtual machine, the host machine can be resolved at the IP address
10.0.2.2 with VirtualBox’s default network settings. Many applications will bind only to
localhost. Refer to the project’s documentation for more information about how to bind to other addresses. Typically, this can be done by passing the host as an environment variable (e.g.
HOST=10.0.2.2 make run).
For the IDP, see: “Testing on a mobile device or in a virtual machine”
Set up JAWS Screen Reader
For windows 10, I (Aaron) needed to make the following adjustments
- Increase system base memory to 6GB
- Use “Intel HD Audio” controller
- I installed this version: