This creates a development environment containing the OS/161 toolchain that you can use to complete the ops-class.org programming assignments. Vagrant is a good option for Mac and Windows users. If you already have Ubuntu installed, you can add our PPA and install the toolchain natively using apt-get.

1. (On Windows) Download Git for Windows. This includes a bash shell which you should use in liue of the terrible Windows shell.

2. (Required) If you already have VirtualBox installed, upgrade to the latest version.

3. (Required) Install Vagrant

4. (Optional) Install two Vagrant plugins:

   1. vagrant plugin install vagrant-vbguest. This ensure that your VirtualBox Guest Additions are up to date.

   2. vagrant plugin install vagrant-timezone. This synchronizes time between your VM guest and host.

Then just vagrant up. The default user and hostname is trinity@zion. The OS/161 toolchain is installed from the OS/161 toolchain PPA. Git is also preinstalled.

The default machine configuration is fairly lightweight: you may want to beef it up a bit. Or not. sys161 is pretty lightweight itself.

Finally, this Git repository is set up to ignore everything by default, to support a common case where students place their source directory alongside the Vagrantfile. The src subdirectory of this directory is shared with the virtual machine by default, mounted in the VM as /home/trinity/src.