Local development with DDEV
🐳 🐘
PHP Docker images with extras.
Local PHP development with Docker made simple. That's DDEV.
We can not recommend DDEV enough. It is an abstraction layer on top of Docker to simplify local PHP development. It's rooted in the Drupal world but is also popular with Craft CMS, Symfony, Laravel and WordPress. DDEV is sponsorware, use it for free to use, donations welcome. It's a command line tool and has many nice features and even plugins.
# Installation
DDEV runs on macOS, Linux, and Windows. It requires a Docker provider to be installed first. Docker Desktop is the standard, OrbStack (macOS) is a lightweight alternative.
# Install DDEV is via Homebrew (macOS) brew install ddev/ddev/ddev # One-time initialization for local HTTPS mkcert -installbash
For Windows or other installation methods, please refer to the official DDEV installation docs.
# Example usage
# 1. Initialize # Navigate to your project's root directory and run: ddev config # This wizard will ask you a few questions about your project. # 2. Start # Spin up the containers: ddev start # 3. Develop # See project details: ddev describe # Open project in browser: ddev launch # Access the container's shell: ddev sshbash
# SSH Keys
To deploy code or sync data with fortrabbit from within the DDEV container, your local SSH keys need to be available. Run this command once per session:
ddev auth sshbash