Skip to content
A toolkit for creating professional WordPress deployments
PHP Ruby
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

WP Stack

A toolkit for creating professional WordPress deployments.


WordPress runs professional sites. You should have a professional deployment to go along with it. You should be using:

  • Version control (like Git)
  • A code deployment system (like Capistrano)
  • A staging environment to test changes before they go live
  • CDN for static assets

Additionally, you should be able to easily scale out to multiple web servers, if needed.

WP Stack is a toolkit that helps you do all that.

WordPress Must-use Plugins

"Must-use" plugins aka mu-plugins are WordPress plugins that are dropped into the {wp-content}/mu-plugins/ directory. They are autoloaded — no need to activate them. WP Stack comes with a number of these plugins for your use:



This is a very simple CDN plugin. Simply configure the constant WP_STACK_CDN_DOMAIN in your wp-config.php or hook in and override the wp_stack_cdn_domain option. Provide a domain name only, like The plugin will look for static file URLs on your domain and repoint them to the CDN domain.

Multisite Uploads


The way WordPress Multisite serves uploads is not ideal. It streams them through a PHP file. Professional sites should not do this. This plugin allows one nginx rewrite rule to handle all uploads, eliminating the need for PHP streaming. It uses the following URL scheme for uploads: {scheme}://{domain}/wp-files/{blog_id}/. By inserting the $blog_id, one rewrite rule can make sure file requests go to the correct blog.

Note: You will need to implement the nginx rewrite rule for this to work.


Capistrano is a deployment tool.


  1. Create a deploy user on your system.
  2. Create an SSH key for deploy, make sure it can SSH to all of your web servers, and make sure it can pull down your site repo code.
  3. Install RubyGems
  4. sudo gem install capistrano capistrano-ext railsless-deploy
  5. Check out WP Stack somewhere on your server
  6. Copy Capistrano/config/SAMPLE.config.rb to Capistrano/config/config.rb
  7. Customize Capistrano/config/config.rb with your application name, repo URL, and deploy path.
  8. Make sure your deploy path is owned by the deploy user.
  9. Switch to the deploy user: su deploy
  10. Run cap deploy:setup to setup the initial shared and releases directories.


  1. Switch to the deploy user: su deploy
  2. Run cap deploy

Rolling Back

  1. Switch to the deploy user: su deploy
  2. Run cap deploy:rollback
Something went wrong with that request. Please try again.