upload your config
Use protobox to build and share your vagrant virtual machines
Protobox is a layer on top of vagrant and a web GUI to setup virtual machines for web development. A single YAML document controls everything that is installed on the virtual machine. Read More.
The fastest way to get started is to browse our existing pre-configured boxes in our explore section. Once you select one, you are ready to get started.
If you are looking to install popular web applications on your virtual machine, check out our applications section.
You can edit your YAML configuration files locally or drag them on this page to load your existing configurations to continue right where you left off.
Protobox is easily installable by pasting one line into your terminal.
Check out our source code to learn more about our project and how to contribute.
Follow us on twitter to stay up to date on new features, bug fixes, and the latest news.
This section you can use to install popular web applications such as wordpress, drupal, symfony, laravel, etc. It is completely optional, so feel free to proceed to the next section.
If you are done configuring, click the big button below.
Choose the operating system for your virtual machine. It may take some time to downloaded the box the first time you run Vagrant. Read more about vagrant boxes here.
Your personal name for the box. This should be unique to your system. If you have multiple boxes running, name each one differently.
IP address to use for accessing the virtual machine. This is the IP address you will need to enter into your hosts file for every virtualhost you create later on.
hosts
Memory to assign to the virtual machine in megabytes (only integers allowed)
Packages to install via the OS package manager. Do not install any web servers, databases, or languages here since you will configure them in later steps. curl and git are automatically installed.
curl
git
You can also add all your ssh keys and config files (id_rsa, config, etc), to the ./data/ssh/ folder. During initial startup they will automatically be copied to the VM.
id_rsa
config
./data/ssh/
You can toggle this setting to globally turn on/off the dotfiles installation.
You can add a git repository of dotfiles here to be copied into the VM. Make sure you also setup SSH keys to access the GIT repository.
AND / OR
You can also add all your dotfiles (.bash_aliases, .vimrc, .gitconfig, etc), to the ./data/dot/ folder. During initial startup they will automatically be copied to the virtual machine.
.bash_aliases
.vimrc
.gitconfig
./data/dot/
You can toggle this setting to turn on/off the apache installation.
The name of this vhost configuration for your own personal reference.
The URL you want to use to access this site on your computer. Don't forget to add this to your hosts file!
Server aliases are secondary ways to access this site on your computer. Typically www.app.dev or any other subdomains you want to have.
www.app.dev
The location of your site's index file, or other landing page on the file system.
80 for normal browsing, if you choose another append it to the URL, ex: http://app.dev:1337
These should be "name value" list of environmental variables you want to access in your code.
"All" is suitable for most installations. Click here for technical information.
Remove this vhost
You can toggle this setting to turn on/off the nginx installation.
You can toggle this setting to turn on/off the PHP installation.
Please select a PHP version that is compatible with the OS that you selected in the vagrant configuration.
You can toggle this setting to turn on/off the PEAR installation.
You can toggle this setting to turn on/off the PECL installation.
CLI debugging will automatically be available via $ xdebug foo.php. Learn more about debugging a remote server.
$ xdebug foo.php
Webgrind is a GUI for XDebug. You can read more about it here.
Learn why you should be using a real debugger.
Logs will be available from http://<ip_address>/xhprof. The IP address is the one you chose here. Learn how to use XHProf
phpMyAdmin will be available at http://ipaddress/phpmyadmin
http://ipaddress/phpmyadmin
Composer will be available as a system service: $ composer
$ composer
Mailcatcher will be available available at: http://ipaddress:1080/
http://ipaddress:1080/
You can toggle this setting to turn on/off the HHVM installation.
You can toggle this setting to turn on/off the HHVM Nightly Package installation.
This will use HHVM to process composer, greatly increasing speed.
You can toggle this setting to turn on/off the Ruby installation.
Ruby gems to install.
You can toggle this setting to turn on/off the MySQL installation.
Assign a password to the root user. Database will only be installed when a password is entered here.
Protobox will import the databases automatically if a DB_NAME.sql is found at ./data/sql/DB_NAME.sql. Optionally you can specify an import file manually above. Make sure this file is inside the VM before running $ vagrant up
DB_NAME.sql
./data/sql/DB_NAME.sql
$ vagrant up
Remove this database
You can toggle this setting to turn on/off the MariaDB installation.
Read more about MariaDB versioning.
You can toggle this setting to turn on/off the RabbitMQ installation.
Ngrok will be available as a system service: $ ngrok
$ ngrok
You can toggle this setting to turn on/off the NewRelic installation.
Insert your newrelic license key here.
You can toggle this setting to turn on/off the NewRelic PHP Agent.
You can toggle this setting to turn on/off the NewRelic Node Agent.
You can toggle this setting to turn on/off the protobox dashboard installation.
The default path to install the dashboard. Virtualhosts will point to this path.
All you have to do now is click the big button. The next page will help guide you into getting your new configuration loaded into protobox.