WordPress Setup runner for Scotch Box
Alternatives To Wpdistillery
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Woocommerce8,57513144 hours ago460October 12, 20212,212otherPHP
A customizable, open-source ecommerce platform built on WordPress. Build any commerce solution you can imagine.
Wp Graphql3,464
2 days ago138gpl-3.0PHP
:rocket: GraphQL API for WordPress
Create Guten Block3,140
8 months ago107mitJavaScript
📦 A zero-configuration #0CJS developer toolkit for building WordPress Gutenberg block plugins.
Plugin Update Checker1,971633018 days ago31July 24, 202283mitPHP
A custom update checker for WordPress plugins. Useful if you don't want to host your project in the official WP repository, but would still like it to support automatic updates. Despite the name, it also works with themes.
Dropkick1,944988a year ago13February 12, 201819mitJavaScript
A JavaScript plugin for creating beautiful, accessible, and painless custom dropdowns.
Amp Wp1,762
a day ago113gpl-2.0PHP
Enable AMP on your WordPress site, the WordPress way.
S3 Uploads1,75643910 hours ago19July 30, 2021177PHP
The WordPress Plugin to Store Uploads on Amazon S3
Redux Framework1,669317 days ago67June 21, 2022otherPHP
Redux is a simple, truly extensible options framework for WordPress themes and plugins!
Wordpress Seo1,618
8 hours ago3June 28, 20221,028otherJavaScript
Yoast SEO for WordPress
4 hours ago18July 12, 20222,604otherPHP
Security, performance, marketing, and design tools — Jetpack is made by WordPress experts to make WP sites safer and faster, and help you grow your traffic.
Alternatives To Wpdistillery
Select To Compare

Alternative Project Comparisons


WPDistillery Logo

Version 2.3.6 (05.11.2018)

Created by wpdistillery.org

I’m putting a lot of time into maintaining WPDistillery. So if you like it, please consider supporting it:

BMC Patreon

What is WPDistillery

WP Distillery does all the work for you when setting up a new WordPress project with Scotch Box. Simply add your preferred theme, plugins, and options into config.yml and you're good to go! With WPDistillery it won't take longer than 5 minutes until you can start working on your new WordPress project.

One simple command will:

  • Install Scotch Box
  • Install and update requirements on the local webserver
  • Download, install, and configure WordPress
  • Set WordPress options
  • Install and activate your favorite WordPress theme (default: WPSeed)
  • Remove default themes
  • Install and activate the plugins defined in the config files
  • Clean the contents, plugins, unused files, and other Wordpress defaults

You're able to adjust which of the above tasks will be executed. Simply set the desired tasks to true or false in the Setup Options section at the bottom of config.yml. All you need to do after customizing your config file is vagrant up. That's it! With that one single command WPDistillery will:

  1. SSH to the VM
  2. Update WP-CLI
  3. Install and configure everything

It also comes with an optional auto-update function and integrated support for Windows. Check out the Changelog for a complete list of changes.

WPDistillery is fully compatible with Scotchbox 3.0


WPDistillery Setup Video



To setup a new project running Scotch Box and WordPress, simply follow these steps:

  1. In a terminal, run: git clone https://github.com/flurinduerst/WPDistillery.git my-project
  2. Customize wpdistillery/config.yml to suit your needs. See configuration file documentation.
  3. Inside the Vagrantfile add your local URL at config.vm.hostname. This should be the same as wpsettings:url: in config.yml.
  4. Run vagrant up from where your Vagrantfile is.

Done! You can now access your project at the local URL (for example yoursite.vm) defined in Step 3. (or at

Note: Currently there's an issue related to ScotchBox that hinders Vagrant from mounting VirtualBox Shared folders. The solution is to install vagrant-vbguest before running vagrant. This will install the correct vbguest package into the box:

vagrant plugin install vagrant-vbguest
vagrant vbguest

Windows Users

Windows users may wish to vagrant plugin install vagrant-winnfsd before vagrant up for a moderate speed increase on sites with a lot of files. WPDistillery will detect WinNFSd support if needed. See Vagrant WinNFSd for more information.

Additional Information

WPDistillery with WP-Multisite

Using this Pull Request you can add multisite capability for your project. We decided to not merge the PR to keep WPDistillery as clean as it is.

Auto Update WordPress and Plugins

If you want to automatically update WordPress and all Plugins on every vagrant up you can remove the comment character at line 26 inside the Vagrantfile.

Windows Support

Using Windows? No Problem! WPDistillery will detect if you're using Windows and if so, automatically convert all files using dos2unix.

Basic Vagrant Commands

  • vagrant up will start the machine. The first ever vagrant up in your project will also install Scotch Box and execute provisioning.
  • vagrant provision will execute provisioning. This is where WPDistillery runs its core function which is installing and configuring WordPress according to config.yml. Before that, it will also update WP-CLI and set the upload size to 64MB. Normally vagrant provision should not be executed manually but can be used to re-run the WPDistillery setup in case you want to re-install WordPress.
  • vagrant reload will restart Vagrant. This is required for changes made in the Vagrantfile to take effect.
  • vagrant halt will shut down the virtual machine.
  • vagrant destroy will destroy all the resources related to the current virtual machine. This action is not reversable.

More informations can be found at vagrantup.com.


Something went wrong within the WPDistillery setup. I'd like to restart the setup:

  • Fix your setting (probably in wpdistillery/config.yml or Vagrantfile)
  • Remove all tables from the scotchbox database
  • Remove the public folder
  • Run vagrant reload --provision



  • Fork it
  • Create your feature branch
  • Commit your changes
  • Push to the branch
  • Create new a Pull Request

Feel free to contact me if you have questions or need any advice.


WPDistillery is released under the MIT Public License.

Note: The "About" section in README.md and the author (@author) notice in the file-headers shall not be edited or deleted without permission. For details, please see License.

Popular Wordpress Projects
Popular Plugin Projects
Popular Content Management Categories

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.