• Getting Started

    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.


    Explore

    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.

    Applications

    If you are looking to install popular web applications on your virtual machine, check out our applications section.

    Continue

    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.


    Install

    Protobox is easily installable by pasting one line into your terminal.

    Install protobox

    Source Code

    Check out our source code to learn more about our project and how to contribute.

    View source

    Follow Us

    Follow us on twitter to stay up to date on new features, bug fixes, and the latest news.

    Follow protobox

     

  • 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.

    Next Section
  • Local Virtual Machine

    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.

    Memory to assign to the virtual machine in megabytes (only integers allowed)

    If you are done configuring, click the big button below.

    Next Section
  • Server Packages

    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.

    Debian / Ubuntu:

    SSH Keys

    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.

    Dotfiles

    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.

    If you are done configuring, click the big button below.

    Next Section
  • Apache Settings

    You can toggle this setting to turn on/off the apache installation.

    Apache Virtual Host #1

    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.

    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.

    Nginx Settings

    You can toggle this setting to turn on/off the nginx installation.

    Nginx Virtual Host #1

    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.

    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.

     

    If you are done configuring, click the big button below.

    Next Section
  • PHP Settings

    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.

    PEAR

    You can toggle this setting to turn on/off the PEAR installation.

    PECL

    You can toggle this setting to turn on/off the PECL installation.

    XDebug

    CLI debugging will automatically be available via $ xdebug foo.php. Learn more about debugging a remote server.

    Webgrind is a GUI for XDebug. You can read more about it here.

    Learn why you should be using a real debugger.

    Xhprof

    Logs will be available from http://<ip_address>/xhprof.
    The IP address is the one you chose here.
    Learn how to use XHProf

    Extras

    phpMyAdmin will be available at http://ipaddress/phpmyadmin

    Composer will be available as a system service: $ composer

    Mailcatcher will be available available at: http://ipaddress:1080/

    HHVM Settings

    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.

    Extras

    Composer will be available as a system service: $ composer

    This will use HHVM to process composer, greatly increasing speed.

    Ruby Settings

    You can toggle this setting to turn on/off the Ruby installation.

    Ruby gems to install.

    If you are done configuring, click the big button below.

    Next Section
  • MySQL Settings

    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.

    MySQL Database #1

    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

    MariaDB Settings

    You can toggle this setting to turn on/off the MariaDB installation.


    Read more about MariaDB versioning.

    Assign a password to the root user. Database will only be installed when a password is entered here.

    MariaDB Database #1

    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

    PostgreSQL is coming soon.
    Mongdb is coming soon.
    Redis is coming soon.
    Riak is coming soon.

    If you are done configuring, click the big button below.

    Next Section
  • RabbitMQ

    You can toggle this setting to turn on/off the RabbitMQ installation.

    Beanstalkd is coming soon.
    IronMQ does not need anything installed on the server. We suggest you use a framework or package that integrates this service in your application.
    Amazon SQS does not need anything installed on the server. We suggest you use a framework or package that integrates this service in your application.

    If you are done configuring, click the big button below.

    Next Section
  • Local Tunnel

    Ngrok will be available as a system service: $ ngrok

    NewRelic

    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.

    Protobox Dashboard

    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.

    If you are done configuring, click the big button below.

    Next Section
  • You're almost there!

    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.