Skip to content
This repository has been archived by the owner before Nov 9, 2022. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Project Archive

This project is no longer hosted or maintained by Mixd. It has been set as a github read-only archive. If you are required to make changes to this repository please seek approval first from either the Digital Director or Service Desk Manager.


Capistrano powered WordPress deployment.

This repository utilises the Capistrano 3 framework to help the deployment and successful launch of a WordPress based website.


That sounds fancy, but what does it actually do?

  • Install WordPress: WordPress is created at a git submodule* and installed based on your pre-defined configuration.
  • Environment based git deployment: Clone an entire repository (from anywhere) to the server. Have separate environments to deploy to? (think: production/staging) We've got you covered.
  • Deployment rollbacks: Realised you deployed a version thats going to break the site? Run a command to revert your changes to the previous version.
  • Push/Pull database with correct URLs: Override the environment's database and run a 'search and replace' through the database to make sure the URLs are correct for that environment.
  • Push/Pull uploads: Update you entire uploads directory from local to or vice versa.
  • Update WordPress: Update your version of WordPress with ease, straight from the Command Line.
  • Configuration templates: Need specific attributes within your .htaccess or wp-config.php? The templates are designed for this in mind and allow you to do this on an environment by environment basis.
  • Setup permissions: Make sure your uploads and .htaccess files are readable from the get-go.


  • Git > v1.7.3: Git is used to pull down the website from your Git hosting and therefore is a mandatory requirement.
  • SSH access: For wp-deploy (or Capistrano in general) to work you need SSH access both between your local machine and your remote server, and between your local machine and your Git hosting (Github, Bitbucket, CodebaseHQ, etc) account.
  • Bundler: As WP-Deploy comes with various different Ruby Dependencies, Bundler is used to make quick work of the installation process. Here's the link
  • WP-CLI (greater than 0.22.0): WP-Deploy also requires the automation of WordPress functions directly in the Command Line. As these functions are required on all environments (local, staging and production servers), we make use of the WordPress Command Line Interface. You can check out the documentation on how to get this setup.

In addition, as this is powered by WordPress, you'll also need to follow WordPress' requirements.

Unsupported/Untested tech

Some of the following tech is more untested than anything else. This could be due to time constraints or unfamiliarity with the software:

  • Nginx
  • Git (lower than version 1.7.3)
  • WP-CLI (lower than version 0.22.0)
  • Capistrano 3.8 or lower.
  • Another shell besides Bash/Zsh for local development
  • WordPress Multisite

Want to support these? Create a fork of the project, let us know and once vetted we'll happily provide a link in here to your project.


Take a look at the Installation Guide.


Take a look at the Usage Guide.


Take a look at the Frequently Asked Questions.


Take a look at the Contributing guide


This project is developed by the Mixd team. Like it? Hate it? Let us know on Twitter.