Pantheon Integration¶

Full integration with Pantheon hosting including Terminus CLI, automated backup management, and multidev environment support.

Configuration¶

Required Variables¶

HOSTING_SITE - Pantheon site machine name
HOSTING_ENV - Default environment for database pulls (dev/test/live)
MIGRATE_DB_SOURCE - Source project for migrations (optional)
MIGRATE_DB_ENV - Source environment for migrations (optional)

Setup Process¶

Get Machine Token Visit Pantheon Dashboard to create a machine token.

Configure Global Authentication

ddev config global --web-environment-add=TERMINUS_MACHINE_TOKEN=your_token_here
ddev restart

Project Configuration

ddev project-configure
# Select Pantheon as provider
# Enter site machine name
# Choose default environment

Features¶

Smart Database Refresh¶

12-hour backup detection: Automatically checks backup age using Terminus API
Environment support: Works with dev, test, live, and multidev environments
Force refresh: Use -f flag to create new backups

# Refresh from default environment
ddev db-refresh

# Refresh from live with force flag
ddev db-refresh live -f

# Refresh from multidev environment
ddev db-refresh feature-branch

Terminus Integration¶

Run any Terminus command through DDEV:

# List all sites
ddev pantheon-terminus site:list

# Check environment info
ddev pantheon-terminus env:info my-site.dev

# Create multidev environment
ddev pantheon-terminus multidev:create my-site.live feature-branch

Test Environment Management¶

Create isolated testing environments:

# Create fresh test environment
ddev pantheon-testenv my-test fresh

# Create from existing environment
ddev pantheon-testenv my-test existing

Environment Tickling¶

Keep environments awake during long operations:

# Start tickling to prevent sleep
ddev pantheon-tickle

Authentication Troubleshooting¶

Check Token Status¶

# Verify token is set
ddev exec printenv TERMINUS_MACHINE_TOKEN

# Test authentication
ddev pantheon-terminus auth:whoami

Re-authenticate¶

# Re-authenticate manually
ddev pantheon-terminus auth:login --machine-token="your_token"

File Proxy Configuration¶

The add-on automatically configures file proxy to serve missing uploads from your live environment:

Seamless local development experience
No need to download all production files
Configurable proxy settings per environment

Multidev Support¶

Full support for Pantheon's multidev environments:

Database refresh from any multidev
Environment creation and management
Seamless switching between environments

# Work with multidev environments
ddev db-refresh my-feature-branch
ddev pantheon-terminus multidev:list my-site

Migration Support¶

Configure migration settings for database operations between different Pantheon sites:

# During configuration, optionally set:
# MIGRATE_DB_SOURCE - Source site machine name
# MIGRATE_DB_ENV - Source environment (dev/test/live)

This enables database operations between different Pantheon projects for complex migration workflows.