diff --git a/devstack/samples/README-Vagrant.md b/devstack/samples/README-Vagrant.md
new file mode 100644
index 000000000..81705a3b0
--- /dev/null
+++ b/devstack/samples/README-Vagrant.md
@@ -0,0 +1,37 @@
+This file describes how to use Vagrant (http://www.vagrantup.com) to
+create a devstack virtual machine that contains two nova instances
+running a simple web server and a working Neutron LBaaS Version 2 load
+balancer.
+
+1) Install vagrant on your host machine.  Vagrant is available for
+Windows, Mac OS, and most Linux distributions.  Download and install
+the package appropriate for your system.  On Ubuntu, simply type:
+
+    sudo apt-get install vagrant
+
+2) copy 'Vagrantfile' from this directory to any appropriate directory
+and run 'vagrant up':
+
+    mkdir $HOME/lbaas-vagrant            # or any other appropriate directory
+    cp Vagrantfile $HOME/lbaas-vagrant
+    cd $HOME/lbaas-vagrant
+    vagrant up
+
+3) Wait for the vagrant VM to boot and install, typically 20-30 minutes
+
+4) SSH into the vagrant box
+
+    vagrant ssh
+
+5) Determine the loadbalancer IP:
+
+    source openrc admin admin
+    neutron lbaas-loadbalancer-show lb1 | grep vip_address
+
+6) make HTTP requests to test your load balancer:
+
+        curl <LB_IP>
+
+where <LB_IP> is the VIP address for lb1.  The subsequent invocations of
+"curl <LB_IP>" should demonstrate that the load balancer is alternating
+between two member nodes.
diff --git a/devstack/samples/Vagrantfile b/devstack/samples/Vagrantfile
new file mode 100755
index 000000000..d7d9dbc72
--- /dev/null
+++ b/devstack/samples/Vagrantfile
@@ -0,0 +1,83 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+# All Vagrant configuration is done below. The "2" in Vagrant.configure
+# configures the configuration version (we support older styles for
+# backwards compatibility). Please don't change it unless you know what
+# you're doing.
+Vagrant.configure(2) do |config|
+  # The most common configuration options are documented and commented below.
+  # For a complete reference, please see the online documentation at
+  # https://docs.vagrantup.com.
+
+  # Every Vagrant development environment requires a box. You can search for
+  # boxes at https://atlas.hashicorp.com/search.
+  config.vm.box = "ubuntu/trusty64"
+
+  # Disable automatic box update checking. If you disable this, then
+  # boxes will only be checked for updates when the user runs
+  # `vagrant box outdated`. This is not recommended.
+  # config.vm.box_check_update = false
+
+  # Create a forwarded port mapping which allows access to a specific port
+  # within the machine from a port on the host machine. In the example below,
+  # accessing "localhost:8080" will access port 80 on the guest machine.
+  #config.vm.network "forwarded_port", guest: 80, host: 8080
+
+  # Create a private network, which allows host-only access to the machine
+  # using a specific IP.
+  # config.vm.network "private_network", ip: "192.168.33.10"
+
+  # Create a public network, which generally matched to bridged network.
+  # Bridged networks make the machine appear as another physical device on
+  # your network.
+  # config.vm.network "public_network"
+
+  # Share an additional folder to the guest VM. The first argument is
+  # the path on the host to the actual folder. The second argument is
+  # the path on the guest to mount the folder. And the optional third
+  # argument is a set of non-required options.
+  # config.vm.synced_folder "../data", "/vagrant_data"
+
+  # Provider-specific configuration so you can fine-tune various
+  # backing providers for Vagrant. These expose provider-specific options.
+  # Example for VirtualBox:
+  #
+  config.vm.provider "virtualbox" do |vb|
+     # Display the VirtualBox GUI when booting the machine
+     vb.gui = true
+     # Customize the amount of memory on the VM:
+     vb.memory = "8192"
+  end
+  #
+  # View the documentation for the provider you are using for more
+  # information on available options
+  # Define a Vagrant Push strategy for pushing to Atlas. Other push strategies
+  # such as FTP and Heroku are also available. See the documentation at
+  # https://docs.vagrantup.com/v2/push/atlas.html for more information.
+  # config.push.define "atlas" do |push|
+  #   push.app = "YOUR_ATLAS_USERNAME/YOUR_APPLICATION_NAME"
+  # end
+
+  # Enable provisioning with a shell script. Additional provisioners such as
+  # Puppet, Chef, Ansible, Salt, and Docker are also available. Please see the
+  # documentation for more information about their specific syntax and use.
+  config.vm.provision "shell", privileged: false, inline: <<-SHELL
+
+    #!/usr/bin/env bash
+
+    sudo apt-get update
+    sudo apt-get -y upgrade
+    sudo apt-get -y install git
+
+    git clone https://git.openstack.org/openstack-dev/devstack
+    git clone https://git.openstack.org/openstack/neutron-lbaas
+
+    cd neutron-lbaas/devstack/samples
+    cp local.* webserver.sh ~/devstack
+    cd ~/devstack
+    ./stack.sh
+
+  SHELL
+
+end