Vagrant Usage


Stephan Meissl


stephan.meissl at


Jeff McKenna


jmckenna at

Last Updated:


Probably the simplest way to run MapServer regression tests is using Vagrant as described below.

Installation and Initial Configuration

Install VirtualBox & Vagrant. The configuration is tested with:

Install Vagrant add-ons:

vagrant plugin install vagrant-vbguest
vagrant plugin install vagrant-cachier
vagrant plugin install sahara

Clone MapServer:

git clone
cd MapServer/

You will notice that an msautotest subdirectory (inside MapServer) exists after your checkout.

Run Vagrant

To initialize Vagrant simply run the following from the MapServer directory:

vagrant up
vagrant ssh

You’re all set to run the tests as described in Regression Testing (msautotest).

Troubleshoot Vagrant

  • If the provisioning didn’t finish during vagrant up or after changes try: vagrant provision

  • (Re-)Install virtualbox guest additions in case it complains about not matching versions: vagrant vbguest -f

  • Slow performance: Check “Enable IO APIC”, uncheck “Extended Features: Enable PAE/NX”, and uncheck “Enable Nested Paging” in VirtualBox Manager.

  • Symlinks with VirtualBox 4.1 not working: vi /opt/vagrant/embedded/gems/gems/vagrant-1.3.5/plugins/providers/virtualbox/driver/version_4_1.rb and add those changes: