What is Vagrant?

Vagrant makes the web development at ease for setting up the different component and share with others. The most take away with using vagrant is the ease of setup(provisioning) and saving the certain shapshot of your work ecosystem.

To use vagrant, virtualization software package is necessary - VirtualBox, VMWare..

Install Vagrant.

Vagrant shipped with support for VirtualBox,Hyper-V and Docker. Download Vagrant and install according to your operating system.

Configuration of vagrant file

Vagrant should be available in your path. Now create a vagrant file

vagrant init hashicorp/precise64

This will use the default ubuntu box. If you want to use other box search at the hashicorp

With the above cmd a vagrant file should be generated with named Vagrantfile This file is core of the configuration of the vagrant where the virtual machine configuration is done with the Provisioning - preinstall all required package.


Basic Networking of the machine configuration at the Vagrant file are:

Forwading Port

config.vm.network "forwarded_port", guest: 80, host: 8080

if you want more port to be forwarded include these and optional protocal can also be define

config.vm.network "forwarded_port", guest: 1337, host: 11337, protocal: "tcp"

Setup your Private Network

This allow host only access to the machine.

config.vm.network "private_network", ip: ""

For more detail configuration on network refer at Vagrant Network configuration

Add Plugin

Install the virtual-box guest addition plugin for syncing the host directory.

  vagrant plugin install vagrant-vbguest


Provisioning is setting up the machine to pre-install software packages and configure automatically. Different Provisioning are supported such as Shell,Puppet, Chef, Ansible, Salt, and Docker. Shell is default one. You can either define inline in the vagrantfie or in a separate script.

Inline shell script

Example of inline shell to update the debian and install Apache can be as :

config.vm.provision "shell", inline: <<-SHELL
   sudo apt-get update
   sudo apt-get install -y apache2

External shell script

To use shell provision witht a external shell script:

config.vm.provision "shell", path: "script.sh"

Remote shell script

For Remote file:

config.vm.provision "shell", path: "https://example.com/provisioner.sh"

Upload File

To upload a file to the guest machine from the host:

config.vm.provision "file", source: "~/httpd.conf", destination: "httpd.conf"


Can perform in two types : Puppet Apply and Puppet Agent

Puppet Apply

Define the manifest and apply the provisioning. This will instruct vagrant that provisioning is going to be puppet.

Vagrant.configure("2") do |config|
  config.vm.provision "puppet"

And by default will look at the ‘manifest’ directory at the current directory and use the default.pp as the entry point.

$ tree
|-- Vagrantfile
|-- manifests
|   |-- default.pp

Puppet Agent

This is defined as the puppet agent and you need to set the location of the puppet master.

Vagrant.configure("2") do |config|
  config.vm.provision "puppet_server" do |puppet|
    puppet.puppet_server = "puppet.example.com"

And defined the node as:

Vagrant.configure("2") do |config|
  config.vm.provision "puppet_server" do |puppet|
    puppet.puppet_node = "node.example.com"

More provision.

Basic commands

The following are some of the basic commands of vagrant that will be used regularly.


vagrant init


vagrant up


This is ssh to the box with the default user/password vagrant/vagrant at default port 2222. Default root password vagrant.

vagrant ssh


This will save the current running state of the machine and stop it. When you are ready to begin working again, just run vagrant up, and it will be resumed from where you left off.

vagrant suspend


This will gracefully shut down the guest operating system and power down the guest machine. You can use vagrant up when you are ready to boot it again.

vagrant halt


This will remove all traces of the guest machine from your system. It’ll stop the guest machine, power it down, and remove all of the guest hard disks. Again, when you are ready to work again, just issue a vagrant up

vagrant destroy


On the first run of vagrant up, if provision is defined it will run. If you want to rerun again then use the flag --provision.

vagrant reload --provision

More on the vagrant cli