PHPackages                             chrico/wordpress-capistrano-starter - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps & Deployment](/categories/devops)
4. /
5. chrico/wordpress-capistrano-starter

AbandonedArchivedProject[DevOps & Deployment](/categories/devops)

chrico/wordpress-capistrano-starter
===================================

Starterkit to deploy your `wp-content`-directory.

08Ruby

Since May 23Pushed 10y ago1 watchersCompare

[ Source](https://github.com/Chrico/wordpress-capistrano-starter)[ Packagist](https://packagist.org/packages/chrico/wordpress-capistrano-starter)[ RSS](/packages/chrico-wordpress-capistrano-starter/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

WordPress Capistrano Starter
============================

[](#wordpress-capistrano-starter)

Table of Contents
-----------------

[](#table-of-contents)

- [Requirements](#requirements)
    - [Install Ruby](#install-ruby)
    - [Install Capistrano](#install-capistrano)
    - [Install Bundler](#install-bundler)
    - [Install Composer](#install-composer)
- [Configure Capistrano](#configure-capistrano)
    - [Basic configuration](#basic-configuration)
    - [Environment](#environment)
- [Local Development](#local-development)
- [Remote Server](#remote-server)
- [Directory structure](#directory-structure)
- [wp-config.php](#wp-configphp)
- [Commands](#commands)
    - [View all available commands](#view-all-available-commands)
    - [Check if everything is fine](#check-if-everything-is-fine)
    - [Deployment and Rollback](#deployment-and-rollback)

Requirements
------------

[](#requirements)

- Ruby >= 2.0
- Capistrano 3.4.0
- Bundler
- Composer
- Access via SSH Key to Server

### Install Ruby

[](#install-ruby)

-
-

```
$ ruby -v
ruby 2.2.3p173 (2015-08-18 revision 51636) [x64-mingw32]

```

### Install Capistrano

[](#install-capistrano)

[Capistrano](http://capistranorb.com/documentation/overview/what-is-capistrano/) is a remote server automation tool. It supports the scripting and execution of arbitrary tasks, and includes a set of sane-default deployment workflows.

Howto install:

```
$ gem install capistrano
$ cap -v
Capistrano Version: 3.4.0 (Rake Version: 10.5.0)

```

### Install Bundler

[](#install-bundler)

[Bundler](https://github.com/capistrano/bundler/) is a package manager for Capistrano v3.

```
$ gem install bundler
$ bundler -v
Bundler version 1.11.2

```

### Install Composer

[](#install-composer)

[Composer](https://getcomposer.org/) is a Dependency Manager for PHP.

- Howto install

Configure Capistrano
--------------------

[](#configure-capistrano)

### Basic configuration

[](#basic-configuration)

Go to `config/deploy.rb` and configure your `application`-name and `repo_url`.

### Environment

[](#environment)

To configure your environment, go to `config/deploy/staging.rb`. The file name equals to your deploy command `cap {environment} deploy` e.G. `cap staging deploy`).

Set your `host`, `user` and `webdir` which is the relative path to your web project on remote server.

Local development
-----------------

[](#local-development)

This Starterkit only represents your `wp-content`-directory and does not restrict your local workflow. You can..

- Replace your `wp-content` locally.
- Create a symlink to this folder in your WordPress-installation.
- Load WordPress via Composer
- ...

To work with Plugins and Themes, just add them to your `composer.json` and run `composer install`.

Remote Server
-------------

[](#remote-server)

### Directory structure

[](#directory-structure)

```
| /cache
| /deployments
|_ current/ ~> ~/deployments/releases/YYYYMMDDHHIISS/
|__ releases/
|___
|__ repo/
|___
|__ shared/
|___
|_ revisions.log
| /tmp
|___ composer.phar
| /www
|___
|___|___ wp-content/ ~> ~/../deployments/current/
| wp-config.php

```

### wp-config.php

[](#wp-configphp)

To load the correct `wp-content/`-folder into your WordPress-installation, you've to add following line to your `wp-config.php`:

```
define( 'WP_CONTENT_DIR', realpath( __DIR__ . '/deployments/current' ) );
```

Commands
--------

[](#commands)

### View all available commands

[](#view-all-available-commands)

```
$ cap -T
```

### Check if everything is fine

[](#check-if-everything-is-fine)

```
cap {environment} deploy:check
```

What happens:

1. Test SSH-connection.
2. Check Git-connection.
3. Create folders withing `deployments/`.

### Deployment and Rollback

[](#deployment-and-rollback)

```
$ cap {environment} deploy
```

What happens:

1. Read the HEAD of the selected branch.
2. Create `shared`-folder if not existing.
3. Update `~/deployments/repo` via `git checkout`.
4. Execute `composer update`.
5. Create `release`-folder if not existing.
6. Create new folder - with date and time as name - in `release`.
7. Copy the current branch from `repo` into this folder.
8. Update all symlinks for `releases/{latest release}` and `shared/` to `current/`.
9. Cleanup old releases - by default the last 5 releases.

```
$ cap {environment} deploy:rollback
```

What happens:

1. Change Symlink on `current/` in `release/{current release - 1}`.

###  Health Score

20

—

LowBetter than 13% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3417446?v=4)[Christian Leucht](/maintainers/Chrico)[@Chrico](https://github.com/Chrico)

---

Top Contributors

[![Chrico](https://avatars.githubusercontent.com/u/3417446?v=4)](https://github.com/Chrico "Chrico (6 commits)")

### Embed Badge

![Health badge](/badges/chrico-wordpress-capistrano-starter/health.svg)

```
[![Health](https://phpackages.com/badges/chrico-wordpress-capistrano-starter/health.svg)](https://phpackages.com/packages/chrico-wordpress-capistrano-starter)
```

###  Alternatives

[ryoluo/sail-ssl

Laravel Sail plugin to enable SSL (HTTPS) connection with Nginx.

192739.0k3](/packages/ryoluo-sail-ssl)[sarfraznawaz2005/servermonitor

Laravel package to periodically monitor the health of your server and website.

19613.5k1](/packages/sarfraznawaz2005-servermonitor)[tiamo/phpas2

PHPAS2 is a php-based implementation of the EDIINT AS2 standard

4676.9k](/packages/tiamo-phpas2)[wapmorgan/php-rpm-packager

RPM packager for PHP applications.

116.5k](/packages/wapmorgan-php-rpm-packager)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)