diff --git a/.gitignore b/.gitignore
index 6ecf39937..cfd9df1cc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -90,3 +90,6 @@ deps/libconfig/libconfig-1.4.9/
 
 #re2
 deps/re2/re2/
+
+test/.vagrant
+.DS_Store
\ No newline at end of file
diff --git a/test/Vagrantfile b/test/Vagrantfile
new file mode 100644
index 000000000..c7c1c01bf
--- /dev/null
+++ b/test/Vagrantfile
@@ -0,0 +1,85 @@
+# -*- 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-14.04"
+
+  # 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 = "1024"
+  # 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", inline: <<-SHELL
+     sudo apt-get update
+     sudo apt-get install -y libmysqlclient-dev python python-dev wget
+     sudo wget -qO- https://bootstrap.pypa.io/ez_setup.py | python
+     sudo easy_install -U pip
+     cd /opt
+     sudo git clone https://github.com/aismail/proxysql-0.2.git proxysql
+     cd proxysql
+     sudo git checkout docker-black-box-tests
+     sudo pip install -r requirements.txt
+  SHELL
+
+  config.vm.provision "shell", run: "always", inline: <<-SHELL
+     cd /opt/proxysql
+     sudo git pull origin docker-black-box-tests
+     sudo pip install -r requirements.txt
+  SHELL
+
+end
diff --git a/test/how_to.md b/test/how_to.md
index 1af9899f8..1581e0852 100644
--- a/test/how_to.md
+++ b/test/how_to.md
@@ -43,4 +43,15 @@ the top-level "test" folder, which inherits from ProxySQLBaseTest. One such
 example is one_backend_test.py. The only thing which you should specify is
 the docker-compose filename, and then start querying both the proxy and the
 MySQL backends and testing assertions by using the `run_query_proxysql` and
-`run_query_mysql' class methods.
\ No newline at end of file
+`run_query_mysql' class methods.
+
+# How do I run the tests locally?
+
+1) install vagrant on the machine where you'll be running the tests
+
+2) vagrant box add ubuntu-14.04 ubuntu-14.04.box
+(The ubuntu-14.04.box file is obtained from https://github.com/jose-lpa/packer-ubuntu_14.04/releases/download/v2.0/ubuntu-14.04.box)
+
+# This will actually install what is needed on the Vagrant box
+3) cd proxysql/test; vagrant up; vagrant ssh -c "cd /opt/proxysql; nosetests --nocapture"; vagrant halt
+