2. Virtual Machine Setup and Use

Starting, entering, exiting

Open a terminal, navigate to the desired location of the Vagrant box and clone the repo with:

git clone https://https://github.com/starlingcode/via-dev-environment.git

Navigate to the newly created directory with:

cd via-dev-environment

To start the Virtual Machine, run:

vagrant up

The first time the VM is started it will download an operating system image and provision it. This process can take a long time (~10-45 minutes). After the initial provisioning future VM startups will take just a few seconds.

Once the VM is running you can connect to it by running:

vagrant ssh

You will now be inside the VM and ready to build, flash, and hack firmware.

You can exit it by running the following command:

exit

Note that after you exit the VM it will still be running! To avoid issues with shared USB devices, disable it with:

vagrant halt

You can bring it back up with

vagrant up

If you would ever like to completely delete the VM and start fresh you can remove it with:

vagrant destroy

Transferring files

Inside the virtual machine the /vagrant path (the default location of the firmware repo and python tool kit) will be syncronized with the location of the Vagrantfile on your real machine. This folder is your portal between the host and the virtual machine for transferring files.