This recipe demonstrates how to run Singularity on your Windows computer via Vagrant and Ubuntu. This recipe may take anywhere from 5-20 minutes to complete.


First, install the following software:

Singularityware Vagrant Box

We are maintaining a set of Vagrant Boxes via Vagrant Cloud, one of Hashicorp many tools that likely you’ve used and haven’t known it. The current stable version of Singularity is available here:

For other versions of Singularity see our Vagrant Cloud repository

Run GitBash. The default home directory will be C:\Users\your_username

mkdir singularity-vm
cd singularity-vm
vagrant init singularityware/singularity-2.3.1
vagrant up
vagrant ssh

You are then ready to go with Singularity 2.3.1!

vagrant@vagrant:~$ which singularity
vagrant@vagrant:~$ singularity --version
vagrant@vagrant:~$ singularity create test.img
Initializing Singularity image subsystem
Opening image file: test.img
Creating 768MiB image
Binding image to loop
Creating file system within image
Image is done: test.img

Note that when you do vagrant up you can also select the provider, if you use vagrant for multiple providers. For example:

vagrant up --provider virtualbox

although this isn’t entirely necessary if you only have it configured for virtualbox.