We're live-coding on Twitch! Join us!
Announcing Scotch Box 2.5

Announcing Scotch Box 2.5

Code Project

Today we're announcing a new release to Scotch Box. If you don't know what Scotch Box is, it's a prepackaged Vagrant box with a ton of LAMP stack features. It exists solely to make Vagrant dead-simple, remove overhead with setting up a PHP stack, and so you don't have to worry about Vagrant breaking all the time.

Scotch Box is a free thing we support and host for the dev community. It currently has 340,000+ downloads and is ranked #9 on the most downloaded Vagrant boxes of all time.

First, some links for reference:

Screen Shot 2015-11-03 at 1.31.52 PM

The newest updates include:

  • General OS updates
  • Laravel Tutorial
  • WordPress Tutorial
  • MongoDB has been added
  • MongoDB PHP extension is added
  • Opcache is disabled
  • Node is updated 5.x
  • Updates to NPM packages (Bower, Gulp, Yeoman, Browser-Sync, PM2)
  • Composer is updated
  • Composer is finally added to Path
  • Laravel executable works out-of-the-box
  • Improvements to PHP MySQL issues
  • WP-CLI has been added per request
  • Mailcatcher is added to test emails finally
  • Created an Update Policy


Upgrading Scotch Box is super easy. Just run

vagrant box update

Debugging the Update

So, Vagrant has this really annoying bug with packaging boxes via vagrant package. We were able to work around this, but if you run into issues, here's some things to try.

Update your OS

Update to Windows to version 10 or Mac OS to El Captain.

Update Vagrant to 1.7.4

You can update Vagrant easily here.

Update Virtual Box to 5.0.x

You can update Virtual Box by visiting their download page. Make sure you download the latest version and its extension pack.

Username Authentication

If you're getting weird authentication issues, you can manually override this by adding this to your Vagrantfile.

config.ssh.username = "vagrant"
config.ssh.password = "vagrant"


Screen Shot 2015-11-03 at 11.37.28 AM

Screen Shot 2015-11-03 at 11.37.36 AM

MongoDB has been added to Scotch Box by default. Robomongo is an awesome Mac client to test this with. You can do SSH tunneling like so:

SSH Address:
Port: 22
SSH Username: vagrant
SSH Password: vagrant

Mongo Host: localhost
Mongo Port: 27017
Mongo DB: scotchbox

With PHP, you can connect like this:

$db = new MongoClient('mongodb://localhost');
$dbs = $db->listDBs();

And, from the mongo Shell, just run:

# SSH into Vagrant box
vagrant ssh

# Test it's working
service mongod status

# Woo, it's working. Let's connect
use scotchbox

Node.js Updates

Node.js recently merged with IO.js. We've updated to Node 5.0. We've also updated all global NPM packages.

Even though these are packaged into the Vagrant box, we always recommend running node and any packages from your local machine and not within the box. This is strictly a performance thing. They only exist as helpers if you don't/can't set those up.

Installing Laravel

Below are instructions for installing Laravel in no time. Alternatively, you can download Laravel manually and just drag and drop. There's also a way to do this with Composer.

cd my/favorite/folder/for/storing/projects
git clone https://github.com/scotch-io/scotch-box my-new-laravel-project
cd my-new-laravel-project
vagrant up
vagrant ssh
cd /var/www
laravel new project # Patience, let it download and do its thing...
rm -rf README.md .gitignore public/ # Removing conflicting files
mv project/* project/.[^.]* . # Put Laravel files in right spot
rm -rf project # All done

Now, you should add .vagrant to the .gitignore. If you visit: you should see L5 at this point!

Alternatively, Laravel's Homestead is probably the best Vagrant setup for Laravel projects although Scotch Box will work perfectly fine.

Installing WordPress

Setting up WordPress is even easier. Here's how:

cd my/favorite/folder/for/storing/projects
git clone https://github.com/scotch-io/scotch-box my-new-wordpress-project
cd my-new-wordpress-project
vagrant up
vagrant ssh
cd /var/www/public
rm index.php
git clone https://github.com/WordPress/WordPress --depth=1 .

Now, just copy wp-config-sample.php to wp-config.php. After this, configure your database settings with MySQL settings in the docs. You're all set!

Using WP-CLI

Since this works out of the box, all you need to do is:

vagrant ssh
wp --info

Using Mailcatcher

Mailcatcher is added to the box so we can test emails. This is already setup and configured, you just need to turn it on. Here's how:

vagrant ssh
mailcatcher --http-ip=

Now, navigate to in your browser to see it in action.

If you want Mailcatcher to start on vagrant up, just add this to your Vagrantfile:

config.vm.provision "shell", inline: <<-SHELL
    mailcatcher --http-ip=

Use Older Versions of Scotch Box

If you hate this, we support older versions. You can set a version of Scotch Box in your Vagrantfile like so:

config.vm.box_version < 2.5

Update Policy and the Future of Scotch Box

We'll continue to support and update the box. It's important to note though that Vagrant is shifting their focus to the Otto Project. The Otto Project does basically what Scotch Box already does for you and gives you a dead-simple LAMP stack. It also has deployments. The problem is this is super-duper alpha. So as it progresses we'll update Scotch Box with details on when you too should make the switch.

Like this article? Follow @whatnicktweets on Twitter