1 files changed, 85 insertions, 0 deletions
diff --git a/docs/content/introduction/testing_in_vagrant.md b/docs/content/introduction/testing_in_vagrant.md
new file mode 100644
index 0000000000..ef1e231393
--- /dev/null
+++ b/docs/content/introduction/testing_in_vagrant.md
@@ -0,0 +1,85 @@
+---
+bookHidden: true
+title: "Running CSIT locally in Vagrant"
+---
+
+# Running CSIT locally in Vagrant
+
+## Install prerequisites
+
+Run all commands from command line.
+
+1. Download and install virtualbox from
+   [official page](https://www.virtualbox.org/wiki/Downloads).
+   To verify the installation, run VBoxManage
+
+   - on windows
+
+         "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" --version
+
+   - on nix
+
+         VBoxManage --version
+         Tested version: 6.1.16r140961
+
+2. Download and install latest vagrant
+   [from official page](https://www.vagrantup.com/downloads.html).
+   To verify the installtion, run
+
+       vagrant -v
+       Tested version: Vagrant 2.2.15
+
+3. Install vagrant plugins::
+
+       vagrant plugin install vagrant-vbguest
+       vagrant plugin install vagrant-cachier
+
+   If you are behind a proxy, install proxyconf plugin and update proxy
+   settings in Vagrantfile::
+
+       vagrant plugin install vagrant-proxyconf
+
+## Set up and run Vagrant virtualbox
+
+Before running following commands change working directory to Vagrant specific directory
+(from within root CSIT directory)
+
+    cd csit.infra.vagrant
+
+This allows Vagrant to automatically find Vagrantfile and corresponding Vagrant environment.
+
+Start the provisioning
+
+    vagrant up --provider virtualbox
+
+Your new VPP Device virtualbox machine will be created and configured.
+Master branch of csit project will be cloned inside virtual machine into
+/home/vagrant/csit folder.
+
+Once the process is finished, you can login to the box using
+
+    vagrant ssh
+
+In case you need to completely rebuild the box and start from scratch,
+run these commands
+
+    vagrant destroy -f
+    vagrant up --provider virtualbox
+
+## Run tests
+
+From within the box run the tests using
+
+    cd /home/vagrant/csit/resources/libraries/bash/entry
+    ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu2004-1n-vbox
+
+To run only selected tests based on TAGS, export environment variables before
+running the test suite
+
+    export GERRIT_EVENT_TYPE="comment-added"
+    export GERRIT_EVENT_COMMENT_TEXT="devicetest memif"
+
+    # now it will run tests, selected based on tags
+    ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu2004-1n-vbox
+
+