Setup a Local Development Environment

This is designed as a guide to get you started with a php development environment on your computer.

  1. Download and install the latest version of VirtualBox from
  2. Download and install the latest version of Vagrant from
  3. Download the file to set up your virtual machine here
    we will be using NGINX on Debian with PHP 5.6
  4. Extract the .zip file and move the contents (Vagrantfile and puphpet folder) to the location on your computer where you would like to store this project.
  5. Using the terminal, or cmd line, cd into your extracted directory and run $ vagrant up. This will kick-off the initial process.
    • Vagrant will download the box file, which can take a few minutes. It will only have to do this once, even if you create separate environments later on.
    • Then, it will hand control over to Puppet which will begin setting up your environment by installing required packages and configuring tools as desired.
    • You will then be able to ssh into your new box with $ vagrant ssh. You can also access any virtual hosts you created by editing your hosts file and creating entries for the Box IP Address and Server Name you provided during configuration (ex:
    • To shut down the VM, simply run $ vagrant halt. To start it back up run$ vagrant up again. Destroy it with $ vagrant destroy.
  6. You will need to open and edit your hosts file with a text editor like notepad, sublime_text, nano, etc. The location of the hosts file varies by operation system.Windows users could look here: c:\windows\system32\drivers\etc\hostsLinux and Mac OSX users could look here: /etc/hosts or /private/etc/hosts.Example Entry:

Leave a Reply

Your email address will not be published. Required fields are marked *