DDEV Kanopi Drupal Add-on

A comprehensive DDEV add-on that provides Kanopi’s battle-tested workflow for Drupal development. This add-on includes complete tooling for modern Drupal development with multi-provider hosting support.

✨ Features

• 30+ Custom Commands - Complete Drupal development workflow
• Multi-Provider Hosting - Pantheon and Acquia support
• Smart Database Refresh - 12-hour backup age detection
• Recipe Development - Drupal 11 recipe creation and management
• Theme Development - Node.js/NPM integration with build tools
• E2E Testing - Cypress and Playwright integration with user management
• Performance Tools - Critical CSS generation and optimization
• Service Integration - Redis/Memcached and Solr support

📚 Documentation

📖 Complete Documentation

Quick Links

🏛️ Hosting Providers

Pantheon Integration

• Nginx Configuration: Automatic proxy setup for missing assets
• Terminus Integration: Full Pantheon API access with machine token
• Smart Backups: 12-hour backup age detection with automatic refresh
• Redis Caching: Optimized object caching for Pantheon environments

Acquia Integration

• Apache-FPM Configuration: Native Apache setup matching Acquia Cloud
• Acquia CLI Integration: Full Acquia Cloud API access
• File Proxy: Apache .htaccess-based proxy for missing files
• Memcached Caching: Optimized caching for Acquia environments

📋 Requirements

• DDEV v1.22.0 or higher
• Existing DDEV project - Must be configured before installing this add-on
• Drupal 8+ project
• Hosting provider account (Pantheon or Acquia) with appropriate credentials
• Node.js (managed by add-on via NVM)

🔧 Management

Update

ddev add-on get kanopi/ddev-kanopi-drupal

Remove

ddev add-on remove kanopi-drupal

🔑 SSH Key Configuration

The refresh scripts use the HOSTING_KEY variable to select a specific SSH key from the agent. Set it in .ddev/config.local.yaml:

web_environment:
  - HOSTING_KEY=id_ed25519

The value should match the comment on your SSH key (the scripts use ssh-add -L | grep "$HOSTING_KEY" to find it). By default it looks for id_rsa.

If your key doesn’t have a comment or uses a different one, you can set or update it:

ssh-keygen -c -C "id_ed25519" -f ~/.ssh/id_ed25519

Verify the comment is set correctly:

ssh-add -L | grep id_ed25519

🤝 Contributing

This add-on is maintained by Kanopi Studios. For issues, feature requests, or contributions, please visit our GitHub repository.

📄 License

This project is licensed under the GNU General Public License v2 - see the LICENSE file for details.