Vagrant project that sets up a devstack environment
Switch branches/tags
Nothing to show
#1 Compare This branch is 45 commits behind bcwaldon:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

DevStack with Vagrant!

Step 1: Install Vagrant

Vagrant uses VirtualBox to handle creation of the actual virtual machines. Head over to to find the appropriate installer for your system.

If you're running Mac OS X, you must also install Xcode. Users running Lion can can install Xcode through the App Store. You can also grab the installer from

Once you've got VirtualBox and Xcode installed, you're ready to install Vagrant. The simplest way to get Vagrant is to use ruby's gem installer :

gem update --system
gem install vagrant

NOTE: This project is intended to work with Vagrant v0.9.X

Step 2: Check Out the Code

Now would be a good time to actually check out the project :

git clone

The project has submodules for other recipes:

git submodule init
git submodule update

Step 3: Configuration

You can set up a local yaml-formatted config file to override the default settings used with the project. Place your config file at etc/vagrant.yaml or set a custom location in the environment variable VD_CONF. See a sample config at etc/vagrant.yaml.sample.

DevStack itself allows you to define a localrc file. This file is injected into your environment and sourced before the environment is built. You can use this to override settings such as MYSQL_PASSWORD or NOVA_REPO. See for more information. If you decide to create your own localrc file, place it at etc/localrc file or set the VD_LOCALRC environment variable to its location.

Step 4: Execution

At this point you can run vagrant up and ssh into your DevStack environment!