PHPackages                             augustash/ddev-pantheon-db - 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. [Database & ORM](/categories/database)
4. /
5. augustash/ddev-pantheon-db

ActiveLibrary[Database & ORM](/categories/database)

augustash/ddev-pantheon-db
==========================

DDEV add-on for fast Pantheon database pulls.

1.0.0(3mo ago)01↓90.9%MITShellPHP >=7

Since Mar 27Pushed 3w agoCompare

[ Source](https://github.com/augustash/ddev-pantheon-db)[ Packagist](https://packagist.org/packages/augustash/ddev-pantheon-db)[ RSS](/packages/augustash-ddev-pantheon-db/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (2)Used By (0)

ddev-pantheon-db
================

[](#ddev-pantheon-db)

A DDEV add-on that provides a fast Pantheon database pull from any environment using Terminus backups.

Installation
------------

[](#installation)

```
ddev add-on get augustash/ddev-pantheon-db
```

If using [augustash/ddev-drupal](https://github.com/augustash/ddev-drupal) or [augustash/ddev-wordpress](https://github.com/augustash/ddev-wordpress), this add-on is installed automatically on `ddev start`.

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

[](#requirements)

- `TERMINUS_MACHINE_TOKEN` set in `~/.ddev/global_config.yaml`
- `DDEV_PANTHEON_SITE` and `DDEV_PANTHEON_ENVIRONMENT` set in `.ddev/config.yaml`

Usage
-----

[](#usage)

```
ddev db        # Pull database if local db is empty or has only one table
ddev db -f     # Force a fresh database pull
```

For Drupal projects, `ddev db` will also run `composer install`, `drush cr`, `drush cim`, and `drush updb` after the pull.

### Pulling from a different environment

[](#pulling-from-a-different-environment)

The pull targets the environment set in `DDEV_PANTHEON_ENVIRONMENT`. To pull from a different environment for a single run, use the `-e` flag:

```
ddev db -f -e=dev
ddev db -f -e=test
ddev db -f -e=pr-123   # a multidev
```

### No environment configured

[](#no-environment-configured)

There is **no default environment** — this is deliberate, so a misconfigured or brand-new site never silently pulls production. If `DDEV_PANTHEON_ENVIRONMENT`is unset (and no `-e` is given), `ddev db` skips the pull with a notice.

How it works
------------

[](#how-it-works)

Creates a fresh database backup of the target environment with `terminus backup:create` and downloads it with `terminus backup:get`. This is the same fast, backup-based transfer for every environment (`live`, `dev`, `test`, or any multidev) — there is no separate live-only code path.

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance90

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

91d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/58f09f3094dbf20ec7c4e7539132ab26b92f16b4aad1aed8812740383ca2af18?d=identicon)[kazajhodo](/maintainers/kazajhodo)

---

Top Contributors

[![kazajhodo](https://avatars.githubusercontent.com/u/1173204?v=4)](https://github.com/kazajhodo "kazajhodo (8 commits)")

---

Tags

ddev-get

### Embed Badge

![Health badge](/badges/augustash-ddev-pantheon-db/health.svg)

```
[![Health](https://phpackages.com/badges/augustash-ddev-pantheon-db/health.svg)](https://phpackages.com/packages/augustash-ddev-pantheon-db)
```

###  Alternatives

[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k116.5M113](/packages/jdorn-sql-formatter)[propel/propel1

Propel is an open-source Object-Relational Mapping (ORM) for PHP5.

8351.6M87](/packages/propel-propel1)

PHPackages © 2026

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