Building a development environment with Vagrant

First, make sure that one of the supported Vagrant providers, Vagrant, and Git are installed on your machine.

Then clone the tsuru-bootstrap project from GitHub:

$ git clone

Enter the tsuru-bootstrap directory and execute vagrant up, defining the environment variable TSURU_NOW_OPTIONS as “–tsuru-from-source”. It will take some time:

$ cd tsuru-bootstrap
$ TSURU_NOW_OPTIONS="--tsuru-from-source" vagrant up

You can optionally specify a provider with the --provider parameter. The following providers are configured in the Vagrantfile:

  • VirtualBox
  • EC2
  • Parallels Desktop

Then configure the tsuru target with the address of the server that vagrant is using:

$ tsuru target-add development -s

Now you can create your user and deploy your apps.