π€© π π π
NEW: SCOTCH BOX 3.5
THE PERFECT AND DEAD SIMPLE LAMP/LEMP STACK FOR LOCAL DEVELOPMENT
Scotch Box Makes Vagrant Easy
git clone https://github.com/scotch-io/scotch-box my-project
cd my-project
vagrant up
Just Clone and Run `vagrant up`
For a business?
Or, Want even more features?
Go "Pro" for More Awesomeness
Also See:
WordPress DistilleryFree Version 3.5 β€οΈ Pro Version 1.5
Just a Dead-Simple Local LAMP/LEMP Stack for Vagrant
This makes Vagrant EASY AS EATING CAKE for developers.
Scotch Box is a pre-configured Vagrant Box with a full array of features to get you up and running with Vagrant in no time.
A lot of PHP websites and applications don't require much server configuration or overhead at first. This box should have all your needs for doing most development so you don't have to worry about configuring Vagrant and you can simply focus on writing code.
No provisioning tools or setup is really even required with Scotch Box. Since everything is packaged into the box, running "vagrant" is super fast, you'll never have to worry about your environment breaking with updates, and you won't need Internet to code.
(and basically any other framework / CMS)
Scotch Box Pro!
Finally available for download and use.
Want more in your local development environment? Check out these additional features by going pro.

Go Pro
Scotch Box is still (and always will be) free!
The original free version does everything you could possibly imagine still and has been improved a ton. Please consider supporting this project by going pro and getting a bit more features and cool things.
Some Pro Features Include:
- NEW OS: Ubuntu-17.10!
- NEW PHP: PHP 7.2!
- NEW APACHE: 2.4.29
- NEW NGINX: 1.13.8
- NEW RUBY via RVM: 2.5.0
- NEW NODE via NVM: 8.9.4
- NEW BUILD SCRIPTS
- Fixes a MongoDB and PHP bug
- Laravel routing works out of the box with the NGINX version
- Adds Drush (Launcher) even though you should do this through Composer these days
- Updated WP-CLI version
- Generally WAY higher versions of everything else
Quick Tutorial
Just clone the repo and run vagrant up.
git clone https://github.com/scotch-io/scotch-box my-project
cd my-project
vagrant up
Then visit:
"I'M A TOTAL NOOB, HELP ME" - YOU
Are you a noobie or absolute beginner? No worries! We have video courses to get you going ASAP.
WPDistillery is an amazing tool by Flurin DΓΌrst that kickstarts your WordPress installation on Scotch Box. It is actively maintained, has lots of features and gets you startet in less than 5 minutes.
All you have to do is clone the repo, customize the configuration file to your needs, and vagrant up. WPDistillery will do the rest:

To get started, visit wpdistillery.org or check out the Documentation.
Box Features
Decked out with everything you'll want and need.
Server Stuff
π€ Feature | π Free Version | π Pro Version |
---|---|---|
OS | Ubuntu 16.04.2 LTS (Xenial Xerus) | Ubuntu 17.10 (Artful Aardvark) |
Web Server | Apache | Apache or NGINX |
PHP | v7.0 | v7.2 |
Python | v2.7 | v2.7 |
Node.js | v6.10.3 | v8.9.4 (via NVM!) |
Go | v1.8 β | v1.83 β |
Ruby | v2.4 | v2.5 (via RVM!) |
Vim | v7.4 | v8.05 |
Git | β | β |
Imagemagick | v6.8.9 | v6.9.7 |
Curl | v7.47 | v7.55 |
Beanstalkd | β | β |
Build Scripts | β | β |
PHP Stuff
π€ Feature | π Free Version | π Pro Version |
---|---|---|
PHP | v7.0 | v7.2.2-3 |
Composer | β | β |
PHPUnit | β | β |
WP-CLI | β | β
(latest) |
Drush (launcher) | β | β
(latest) |
PHP Errors On | β | β |
Will Short Tags work? | β | β |
Modules (everything you would ever need · may have slight variation in versions) |
||
Core
PDO PDO_ODBC Phar Reflection SPL SimpleXML OPcache apache2handler bcmath bz2 calendar ctype curl date dom enchant exif fileinfo filter ftp gd gettext hash iconv igbinary imagick imap intl json ldap libxml mbstring mcrypt memcached mongodb mysqli mysqlnd odbc openssl pcre pdo_mysql pdo_pgsql pdo_sqlite pgsql posix pspell readline redis session shmop sockets sqlite3 standard sysvmsg sysvsem sysvshm tidy tokenizer wddx xml xmlreader xmlrpc xmlwriter xsl zip zlib |
Framework Ready?
π€ Framework | π Free Version | π Pro Version |
---|---|---|
Laravel |
β
β
Depends on your Laravel version. Laravel 5.6+ requires a whopping PHP >= 7.1.3 |
β |
CakePHP | β | β |
Symfony | β | β |
Zend | β | β |
Phalcon | β | β |
CodeIgniter | β | β |
Yii / Yii 2 | β | β |
Nette | β | β |
Fuel PHP | β | β |
Fat-Free | β | β |
Aura | β | β |
Slim | β | β |
Other | Probably! | Probably! |
CMS Ready?
π€ Framework | π Free Version | π Pro Version |
---|---|---|
WordPress | β | β |
Drupal | β | β |
Joomla! | β | β |
Craft CMS | β | β |
Magento | β | β |
Concrete5 | β | β |
ExpressionEngine | β | β |
Other | Probably! | Probably! |
MySQL Stuff
π€ Feature | π Free Version | π Pro Version |
---|---|---|
Version | v.5.7 | v.5.7.21 |
Hostname | localhost | localhost |
Username | root | root |
Password | root | root |
Database | scotchbox | scotchbox |
PostgreSQL Stuff
π€ Feature | π Free Version | π Pro Version |
---|---|---|
Version | v9.5.6 | v9.6.7 |
Hostname | localhost | localhost |
Username | root | root |
Password | root | root |
Database | scotchbox | scotchbox |
Port | 5432 | 5432 |
MongoDB Stuff
π€ Feature | π Free Version | π Pro Version |
---|---|---|
Support? | β | β |
Hostname | localhost | localhost |
Port | 27017 | 27017 |
SQLite Stuff
π€ Feature | π Free Version | π Pro Version |
---|---|---|
Support? | β | β |
Memcached Stuff
π€ Feature | π Free Version | π Pro Version |
---|---|---|
Version | β | β |
Hostname | localhost | localhost |
Port | 11211 | 11211 |
Redis Stuff
π€ Feature | π Free Version | π Pro Version |
---|---|---|
Version | β | β |
Hostname | localhost | localhost |
Port | 6379 | 6379 |
Node.js Stuff
π€ Feature | π Free Version | π Pro Version |
---|---|---|
Version | v6.10.3 | v8.9.4 |
NVM | β | β |
gulp | β | β |
grunt | β | β |
bower | β | β |
yo | β | β |
browser-sync | β | β |
browserify | β | β |
pm2 | β | β |
webpack | β | β |
SSH Stuff
Typically you will just run vagrant ssh
, but it's good to know this too.
π€ Feature | π Free Version | π Pro Version |
---|---|---|
Host | 127.0.0.1 | 127.0.0.1 |
User | vagrant | vagrant |
Password | vagrant | vagrant |
Port | 2222 | 2222 |
Email Stuff
Test emails locally! This is already setup with PHP too. You just need to turn it on.
π€ Feature | π Free Version | π Pro Version |
---|---|---|
Software | MailHog | MailHog |
How? | Automatically on | Automatically On |
URL / Where? | http://192.168.33.10:8025 | http://192.168.33.10:8025 |
License Stuff
Use at your own risk / responsibility. We make no guarantee of anything in the free or pro versions. For support, please visit the GitHub page.
The MIT License |
---|
Copyright (c) 2017-2020 Nicholas Cerminara, scotch.io, LLC Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
Learn More About Pro