Hosting Providers¶

The DDEV Kanopi Drupal Add-on provides comprehensive support for multiple hosting providers with platform-specific optimizations and integrations.

Supported Providers¶

Provider	Status	Configuration	Webserver	Database	Caching
Pantheon	✅ Full Support	Terminus API	Nginx + Proxy	MariaDB 10.6	Redis
Acquia	✅ Full Support	Acquia CLI	Apache-FPM	MySQL 5.7	Memcached

DDEV Configuration Requirements¶

Important: This add-on requires specific DDEV configurations for each hosting provider. Set these up before installing the add-on:

Pantheon Projects¶

# Required DDEV configuration for Pantheon
ddev config --project-type=drupal10 --docroot=web --database=mariadb:10.6
ddev start

# Then install and configure the add-on
ddev add-on get kanopi/ddev-kanopi-drupal
ddev project-configure

Acquia Projects¶

# Required DDEV configuration for Acquia
ddev config --project-type=drupal10 --docroot=docroot --webserver-type=apache-fpm --database=mysql:5.7
ddev start

# Then install and configure the add-on
ddev add-on get kanopi/ddev-kanopi-drupal
ddev project-configure

Provider Selection¶

Choose your hosting provider using the interactive configuration wizard:

# Interactive configuration (recommended)
ddev project-configure

# Manual configuration (if needed)
ddev config --web-environment-add HOSTING_PROVIDER=pantheon
# or
ddev config --web-environment-add HOSTING_PROVIDER=acquia
ddev restart

Platform Comparison¶

Pantheon¶

Best for: High-traffic sites, integrated CI/CD, automatic updates
Strengths: Excellent performance, built-in CDN, robust backup system
DDEV Integration: Automatic nginx proxy, Terminus CLI, smart backup detection

Acquia¶

Best for: Enterprise sites, complex architectures, compliance requirements
Strengths: Advanced security, multi-region deployments, comprehensive tooling
DDEV Integration: Apache-FPM compatibility, Acquia CLI, file proxy system

Common Features¶

All supported hosting providers include:

Smart Database Refresh¶

12-hour backup detection: Automatically checks backup age
Force refresh: Use -f flag to create new backups
Environment support: Pull from any environment (dev, test, live, multidev)
Post-refresh actions: Automatic user creation and cache clearing

Asset Proxy¶

Missing file handling: Automatically proxy missing assets from hosting environment
Development efficiency: No need to download all media files locally
Seamless integration: Transparent to your development workflow

API Integration¶

Native CLI tools: Direct access to hosting provider APIs
Automated workflows: Streamlined deployment and backup processes
Environment management: Create and manage environments programmatically

Provider-Specific Configuration¶

For detailed configuration instructions for each provider, use the interactive configuration wizard:

ddev project-configure

This will guide you through setting up the appropriate environment variables and hosting provider settings.

Multi-Provider Workflows¶

Migration Between Providers¶

The add-on supports migrating between hosting providers:

# Configure source for migration
ddev config --web-environment-add MIGRATE_DB_SOURCE=old-site
ddev config --web-environment-add MIGRATE_DB_ENV=live

# Set up secondary database for migration
ddev db-prep-migrate

# Your migration process here...

Development with Multiple Providers¶

You can work with multiple providers in different projects:

# Project A (Pantheon)
cd project-a
ddev config --web-environment-add HOSTING_PROVIDER=pantheon

# Project B (Acquia)
cd project-b
ddev config --web-environment-add HOSTING_PROVIDER=acquia

Global credentials are shared across projects for convenience.