PMBox stands for ProcessMaker Box, an easy solution to virtualize a server and provision it with Puppet to install and start using ProcessMaker.

Apart from ProcessMaker, PMBox installs git and PHPMyAdmin as additional tools, so it's ready for plugin development and testing.

Updated to processmaker community 3.3.0 with php 5.6 and mysql 5.6

From Windows to Linux and Mac OS X, PMBox works without any extra requirements or configuration hassles.

• VirtualBox 4.2+ virtualbox.org/wiki/Downloads
• Extension Pack for VirtualBox virtualbox.org/wiki/Downloads
• Vagrant 1.1+ vagrantup.com

Check out Vagrant's official documentation http://docs.vagrantup.com/v2/installation/index.html

Once you have VirtualBox and Vagrant installed, place the following on your terminal (you need git):

$ git clone git://github.com/yamilurbina/PMBox.git
$ cd PMBox

Let's start our PMBox machine with a single command:

$ vagrant up

From there, Vagrant will take charge and start showing information like this:

Bringing machine 'default' up with 'virtualbox' provider...
[default] Importing base box 'pmbox'…
[default] Setting the name of the VM...networking...
[default] Clearing any previously set forwarded ports...
[default] Creating shared folders metadata...
[default] Clearing any previously set network interfaces...

Now it's the perfect time to get some coffee, and depending on your internet connection speed, the process shouldn't take more than 5-8 minutes.

Once everything completes on the vagrant side, open http://localhost:8080 and follow the ProcessMaker wizard to finish the installation.

Note: When prompted for the MySQL password, type: processmaker

SSH access is provided by vagrant, check out their official documentation: http://docs.vagrantup.com/v2/cli/ssh.html

Open http://localhost:8080/mysql

user: root
password: processmaker

PMBox is able to generate ProcessMaker plugins out of the box. Follow this steps to generate a simple plugin. Inside your box (SSH), type:

$ cd /opt/processmaker/workflow/engine
$ php gulliver new-plugin PMBoxDemoPlugin

From there, gulliver will prompt you for the features you need for your plugin. To read more about this and also set the symlinks for your plugin, you can check the official ProcessMaker wiki page: http://wiki.processmaker.com/index.php/2.0.36/Plugin_Development

Browse to the plugins folder on your PMBox directory to find the plugins generated by gulliver. From there, you can edit your files on a text editor and the changes will be reflected instantly.

For any doubts, feedback, improvements or just chat, I'm just a tweet away: @yamilurbina or visit my website: yamilurbina.com

I really hope you enjoy PMBox as much as I enjoyed developing it. The need for a descentralized way to work on ProcessMaker was something that needed a solution, and this, paired with the wonderful duo of VirtualBox and Vagrant, makes it come true.

And of course, this is free to use, modify, fork and publish.