PHPackages                             terminus-plugin-project/terminus-backup-all-plugin - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. terminus-plugin-project/terminus-backup-all-plugin

ActiveTerminus-plugin[Utility &amp; Helpers](/categories/utility)

terminus-plugin-project/terminus-backup-all-plugin
==================================================

Backup All - A Terminus plugin to backup all available Pantheon sites with one command.

2.0.0(7y ago)21.5kMITPHPPHP ^5.5 || ^7.0

Since Dec 27Pushed 7y ago1 watchersCompare

[ Source](https://github.com/terminus-plugin-project/terminus-backup-all-plugin)[ Packagist](https://packagist.org/packages/terminus-plugin-project/terminus-backup-all-plugin)[ Docs](https://github.com/terminus-plugin-project/terminus-backup-all-plugin)[ RSS](/packages/terminus-plugin-project-terminus-backup-all-plugin/feed)WikiDiscussions 2.x Synced 3w ago

READMEChangelog (10)Dependencies (1)Versions (19)Used By (0)

Terminus Backup All Plugin
==========================

[](#terminus-backup-all-plugin)

Version 2.x

[![CircleCI](https://camo.githubusercontent.com/d6d842d157fdcb5bd85e2118d5e9e750645ca16235301182d6d8847bb478afbf/68747470733a2f2f636972636c6563692e636f6d2f67682f7465726d696e75732d706c7567696e2d70726f6a6563742f7465726d696e75732d6261636b75702d616c6c2d706c7567696e2e7376673f7374796c653d736869656c64)](https://circleci.com/gh/terminus-plugin-project/terminus-backup-all-plugin)[![Terminus v2.x Compatible](https://camo.githubusercontent.com/4cf69d5d2946c607d2f77591c24ad1f265f4d8d0b492255a97a7e5a03730aa7a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7465726d696e75732d76322e782d677265656e2e737667)](https://github.com/terminus-plugin-project/terminus-backup-all-plugin/tree/2.x)[![Terminus v1.x Compatible](https://camo.githubusercontent.com/9ea8fb0893368c0b24f172cc2df676fa4bb7246d14c0377b7924a6918065be26/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7465726d696e75732d76312e782d677265656e2e737667)](https://github.com/terminus-plugin-project/terminus-backup-all-plugin/tree/1.x)[![Terminus v0.x Compatible](https://camo.githubusercontent.com/275e0fbd20cfb6f5eeb401daf333848da99283a3904b6b8482de0d62e0d04f62/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7465726d696e75732d76302e782d677265656e2e737667)](https://github.com/terminus-plugin-project/terminus-backup-all-plugin/tree/0.x)

Terminus plugin to backup all available Pantheon sites with one command.

Usage:
------

[](#usage)

```
$ terminus backup-all:[create|get|list] [--env=] [--element=] [--framework=] [--skip=] [--date=] [--changes=] [--team] [--owner=] [--org=] [--name=] [--async]
```

The associative arguments are all optional and the same filtering rules as the `terminus site:list` command apply.

The **--env** option value filters by environment. Valid values include **dev, test, live** or any valid multidev environment.

The **--element** option value filters by element. Valid values include **code, database or files**.

The **--framework** option value filters by framework. Valid values include **backdrop, drupal, drupal8 or wordpress**.

The **--skip** option value is a comma separated list of one or more elements, entire environments or specific site environments to omit from backups.

The **--date** option value filters by a specified date (or colon separated range) and returns the backups for any date if omitted.

The **--changes** option is only necessary when the environment is in sftp connection mode and decides how to handle pending filesystem changes. Valid values include **commit, ignore or skip** and the default is **commit** which will create an automatic commit of any pending filesystem changes before completing the backup. The difference between **ignore** and **skip** is **ignore** will continue and make the backup anyway **(without pending filesystem changes)**, whereas **skip** will not.

The **--async** option value will process the request asynchronously.

Examples:
---------

[](#examples)

```
$ terminus ball:create
```

This is an alias for the `terminus backup-all:create` command and will backup all elements of all environments for all available sites and perform the backup after committing pending filesystem changes.

```
$ terminus ball:create --async
```

Same as above but process the request asynchronously.

```
$ terminus ball:create --element=code --changes=ignore --skip=test,my-experiment.dev
```

Backup the code only of all environments for all available sites and perform the backup without committing pending filesystem changes, skipping all test environments and the specific site environment `my-experiment.dev`.

```
$ terminus ball:create --framework=drupal,drupal8
```

Backup all elements of all environments for all available sites that include the drupal and drupal8 (Drupal 6, 7 and 8) frameworks and perform the backup after committing pending filesystem changes.

```
$ terminus ball:list
```

This is an alias for the `terminus backup-all:list` command and will list the backups of all elements in all available site environments.

```
$ terminus ball:list --env=dev
```

List the backups of all elements in the dev environment only of all available sites.

```
$ terminus ball:list --element=code
```

List the backups of the code only for all available site environments.

```
$ terminus ball:list --framework=drupal,drupal8
```

List the backups of all elements in all environments for all available sites that include the drupal and drupal8 (Drupal 6, 7 and 8) frameworks.

```
$ terminus ball:list --date=YYYY-MM-DD
```

List the backups for all available site environments on the specified date.

```
$ terminus ball:list --date=YYYY-MM-DD:YYYY-MM-DD
```

Same as above but within the specified colon separated date range.

```
$ terminus ball:list --name=awesome --date=YYYY-MM-DD
```

List the backups for all available site environments on the specified date that contain `awesome` in the name.

```
$ terminus ball:get
```

This is an alias for the `terminus backup-all:get` command and will retrieve the latest files backup for all available site environments.

```
$ terminus ball:get --name=awesome
```

Retrieve the latest files backup for all available site environments that contain `awesome` in the name.

```
$ terminus ball:get --element=db
```

Retrieve the latest database backup for all available site environments.

```
$ terminus ball:get --framework=drupal,drupal8
```

Retrieve the latest files backup of all environments for all available sites that include the drupal and drupal8 (Drupal 6, 7 and 8) frameworks.

```
$ terminus ball:get --env=dev --element=code --date=YYYY-MM-DD
```

Retrieve the latest code backup of the dev environment only for all available sites on the specified date.

```
$ terminus ball:get --env=dev --element=code --date=YYYY-MM-DD:YYYY-MM-DD
```

Same as above but within the specified colon separated date range.

```
$ terminus ball:get --name=awesome --date=YYYY-MM-DD
```

Retrieve the latest files backup for all available site environments on the specified date that contain `awesome` in the name.

Installation:
-------------

[](#installation)

For installation help, see [Extend with Plugins](https://pantheon.io/docs/terminus/plugins/).

```
mkdir -p ~/.terminus/plugins
composer create-project -d ~/.terminus/plugins terminus-plugin-project/terminus-backup-all-plugin:~2
```

Testing:
--------

[](#testing)

Replace `my-test-site` with the site you want to test:

```
export TERMINUS_SITE=my-test-site
cd ~/.terminus/plugins/terminus-backup-all-plugin
composer install
composer test
```

Configuration:
--------------

[](#configuration)

If you wish to automate backups, see the core `terminus backup:automatic` command.

Help:
-----

[](#help)

Run `terminus help ball:[create|get|list]` for help.

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 83.9% 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.

###  Release Activity

Cadence

Every ~56 days

Recently: every ~73 days

Total

15

Last Release

2677d ago

Major Versions

0.x-dev → 1.0.12017-01-21

1.x-dev → 2.0.02019-02-23

PHP version history (2 changes)0.x-devPHP &gt;=5.4

1.0.1PHP ^5.5 || ^7.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/24785343?v=4)[Terminus Plugin Project](/maintainers/terminus-plugin-project)[@terminus-plugin-project](https://github.com/terminus-plugin-project)

---

Top Contributors

[![uberhacker](https://avatars.githubusercontent.com/u/387945?v=4)](https://github.com/uberhacker "uberhacker (26 commits)")[![sean-e-dietrich](https://avatars.githubusercontent.com/u/1564748?v=4)](https://github.com/sean-e-dietrich "sean-e-dietrich (4 commits)")[![hugovk](https://avatars.githubusercontent.com/u/1324225?v=4)](https://github.com/hugovk "hugovk (1 commits)")

---

Tags

backupcomposerpantheonpluginterminusterminus-backupterminus-pluginpluginbackuppantheonterminus

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/terminus-plugin-project-terminus-backup-all-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/terminus-plugin-project-terminus-backup-all-plugin/health.svg)](https://phpackages.com/packages/terminus-plugin-project-terminus-backup-all-plugin)
```

###  Alternatives

[ergebnis/composer-normalize

Provides a composer plugin for normalizing composer.json.

1.1k40.0M2.6k](/packages/ergebnis-composer-normalize)

PHPackages © 2026

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