Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time

Vagrant Examples

What is Vagrant?

Vagrant is a tool that uses Oracle's VirtualBox to dynamically build configurable, lightweight, and portable virtual machines. Vagrant supports the use of either Puppet or Chef for managing the configuration. Much more information is available on the Vagrant web site.

What is this project?

This is a collection of sample Vagrant configurations using Puppet. They start out very simple with the bare minimum and gradually get more complex. The examples use Ubuntu 12.04, though they should work with any Debian-based Linux distribution. Other distros such as Fedora and SUSE could be supported with some Facter logic in the manifests to ensure that platform-specific packages are installed correctly (e.g. httpd vs apache2).

How do I install Vagrant?

The host OS used in testing these examples was Mint 14 (Ubuntu-based), but any OS should work as long as VirtualBox can be installed. The Vagrant version used in these examples is v1.1.0. The Vagrant download page lists several options for installing v1.1.0.

How do I run the examples?

From one of the example directories, type the following commands...

vagrant box add precise32
vagrant up
vagrant ssh
vagrant destroy

These commands will bring up the Vagrant box, SSH into it, and then remove it respectively.

Summary of examples

  1. Single box with some custom configuration.
  2. Single box with VirtualBox provider.
  3. Single box with VirtualBox provider and Puppet provisioning.
  4. Single box with Apache and sample static site installed via Puppet.
  5. Separate Web and database servers serving up static/dynamic sites via Puppet.
  6. Pulling out all the stops with cluster of seven Vagrant boxes.
  7. Single box with AWS provider and sample static/dynamic sites via Puppet.


A collection of sample Vagrant configurations using Puppet. Starting out simple and getting more complex.






No releases published


No packages published