Boss Box

A modern, easy to configure, WordPress ready Vagrant box, perfect for local development.

Credits

This project was inspired by Scotch Box and built using the Scotch Box Pro build scripts by Nicholas Cerminara. If you like this project, please also consider supporting Nick by purchasing a Scotch Box Pro license at a mere $15.

What's included?

Base Web Server Stack (LAMP)

Ubuntu 16.04 LTS
Apache 2
MySQL 5.7
PHP 7.0

Utilities

Git
Vim
Imagemagick
Curl

Additional Software

Configuration options

Edit sitename, IP address, database name, and MySQL root password
Set Virtual Machine memory size
Ability to enable/disable update checks (when working offline)

Required Software

Make sure you have the following software installed

Recommended Software

Vagrant Hosts Updater

This plugin will allow your system to manage writing to the hosts file automatically, instead of having to edit /etc/hosts each time.

A note on Vagrant box size

The Boss Box image is approximately 900mb in size. This means that the first time you use it, you'll have to download it to your hard drive, meaning your first vagrant up could take a little while.

Initial Setup (Linux/OSx)

From a terminal window:

Clone the github repo

git clone [email protected]:jonathanbossenger/boss-box-lamp.git

Switch to the boss-box-lamp directory

cd boss-box-lamp

Copy the 'vagrant' folder to your project web root

cp -r vagrant/ /path/to/myproject/webroot/vagrant/

Switch to the project vagrant directory

cd ~/path/to/myproject/webroot/vagrant/

Edit the settings.yaml file in the newly copied /path/to/myproject/webroot/vagrant/ directory as required.

Start BossBox

vagrant up

Basic Vagrant Usage

vagrant up

Start the virtual machine

vagrant halt

Stop the virtual machine

vagrant ssh

Create a new WP Site

vagrant ssh

Switch to the /var/www/public directory

cd /var/www/public

Download WordPress via the CLI

wp core download

Create the wp-config.php file, replace {database_name} and {password} with the values you set for those fields in your settings.yaml.

wp config create --dbname={database_name} --dbuser=root --dbpass={password}

Run the famous 5 second WP-CLI install, replace {sitename} with the value you set for that field in your settings.yaml and change the rest to suit your needs.

wp core install --url={sitename} --title=Example --admin_user=supervisor --admin_password=strongpassword --admin_email[email protected]

Browse to your Vagrant IP address or sitename and see your WP instal.

Access

You can access the local site by either the IP address or sitename specified in your settings.yaml (if you have set the relevant /etc/hosts record)

http://192.168.33.10 or http://sitename

PHPMyAdmin

http://192.168.33.10/phpmyadmin or http://sitename/phpmyadmin

MailHog

http://192.168.33.10:8025 or http://sitename:8025

Using Xdebug with PHPStorm

This box has Xdebug installed and is setup to make use of the Zero-configuration Debugging with PhpStorm

Either setup the PHPStorm Bookmarklets or install the Xdebug helper for Chrome
Start debugging from the browser using whichever option you've chosen above
Make sure PHPStorm is listening for incoming debug connections (Run > Start listening for PHP debug connections)
Set breakpoints in your PHPStorm code window
Refresh your project url

On the first run, PHPStorm will ask you to map the debugger to a local path, you should be able to accept the defaults.