Vagrant/Puppet GUI
HTML CSS PHP Shell Ruby JavaScript Other
Latest commit bf1f9e6 Mar 28, 2017 @jtreminio jtreminio Adds resolv support
Squashed commit of the following:

commit 80ef3a40722577227ac54f7ce27234c5c59a89bd
Author: Juan Treminio <>
Date:   Mon Mar 27 18:15:04 2017 -0500

    puppet-puphpet resolv support

commit 24f428c8b11efea6ba4d85b4c0b19f5e2716a47e
Author: Juan Treminio <>
Date:   Mon Mar 27 18:12:13 2017 -0500

    firewall-container -> ruby-container

commit e7859a2a4aa94f2cbd0908da781d3a7cd73a6add
Author: Juan Treminio <>
Date:   Mon Mar 27 18:12:01 2017 -0500

    Adds resolv page

commit 16c035aa827903ce0a8d4b2805319a6b90d62e32
Author: Juan Treminio <>
Date:   Mon Mar 27 16:16:22 2017 -0500

    Adds saz/resolv_conf


PuPHPet - A simple GUI to set up virtual machines for PHP development

Build Status Code Climate


PuPHPet is a web application that allows you to easily and quickly generate custom Vagrant and Puppet controlled virtual machines.

If you're unfamiliar with either Vagrant or Puppet, I wrote a blog titled "Make $ vagrant up yours".


PHP drives the frontend, using the "Symfony2 framework". Choices are set into a yaml file that configures the main Puppet manifest with your custom settings.


I started using Vagrant and Puppet when I wanted a simple PHP 5.4 VM to do my development on. I could find nothing pre-made that didn't come with a bunch of cruft I did not want so I decided to create a tool that would ease this task for other developers who may not want to learn Puppet's DSL to get a VM up and running so they can develop in their language of choice.


Originally developed by Juan Treminio, PuPHPet has now had 29 contributors (as of 12/15/13), with the talented Frank Stelzer heavily contributing. Also making significant contributions is Michaël Perrin.

Sometime in mid August 2013, work on v2 was begun to attempt to solve problems encountered with v1: difficult to add new features, too much PHP logic controlling Puppet logic, difficult to change an existing manifest.


The main goal of PuPHPet is to eventually replace tools such as XAMPP, WAMPP, MAMPP and other all-in-one servers that create development environments on your main operating system.

Eventually PuPHPet will be good enough to help create production-ready servers!


To run PuPHPet-generated manifests, you'll need to install Vagrant version 1.8.6 or greater. Vagrant will run on Windows, OS X and Linux.


If you have a patch, or stumbled upon an issue with PuPHPet core, you can contribute this back to the code. Please read our contributor guidelines for more information how you can do this.


PuPHPet is licensed under the MIT license all third-party Puppet

Modules are licensed under Apache License v2.0.

Clearmin Design licensed under GPLv3 with an exemption provided for PuPHPet.