Installing drupal using vagrant

If you are running a windows system, it can be difficult to setup several pristine drupal development environments. The simple solution is to install a virtual machine, setup your drupal such that it has no affect on the rest of your system. A better solution is to use a virtual machine workflow system that will allow you to easily create and work with several virtual machines. Vagrant is such a system and in here you will learn how to set it up.

Vagrant error occurred while downloading the remote file


An error occurred while downloading the remote file. The error message, if any, is reproduced below. Please fix this error and try again.


You are running vagrant init outside your virtual box


cd to your vagrant directory. If you did a vagrant box add solar, then your virtual box is in the directory solar.

$ cd solar

If there is not VagrantFile, run the following command:

$ vagrant init 

If there is a VagrantFile

$ vagrant up

Timed out while waiting for the machine to boot in vagrant

If you see the following error message, this post shows how to fix the problem.

Timed out while waiting for the machine to boot. This means that
Vagrant was unable to communicate with the guest machine within
the configured ("config.vm.boot_timeout" value) time period.

Naturally, the first thing that would come to your mind would be to increase config.vm.boot_timeout value. This would work if the bottleneck is the boot_timeout. However, if something is hanging, the boot will never complete regardless of the timeout value you set.

Vagrant cheat sheet

Command Description
vagrant up start vagrant
vagrant halt stop vagrant
vagrant reload restart vagrant
vagrant box list list vagrant virtual boxes
vagrant box add box-title url add virtual box
vagrant box remove box-title delete virtual box

Provisioning vagrant

This article shows you how to provision your vagrant. We will start with a very simple dumb box and add features incrementally.


You need to have virtualbox and vagrant installed on your system before following this article.

Basic box

Lets begin by creating the most basic vagrant box.