Skip to content
Switch branches/tags

Latest commit


* Remove app.DBImage and app.DBAImage
* Add conversion and use of new database yaml
* docs for database config
* Remove docs mention of dbimage/dbaimage

Git stats


Failed to load latest commit information.
Latest commit message
Commit time


CircleCI project is maintained Gitpod Ready-to-Code

ddev logo

ddev is an open source tool that makes it simple to get local PHP development environments up and running in minutes. It's powerful and flexible as a result of its per-project environment configurations, which can be extended, version controlled, and shared. In short, ddev aims to allow development teams to use Docker in their workflow without the complexities of bespoke configuration.

Getting Started

  1. Check System Requirements: We support recent versions of macOS, Windows 10, and Linux distributions that will run Docker (ddev requires Docker and docker-compose). (more info here).
  2. Install ddev: Options include macOS homebrew (recommended), an install script, or manual installation.
  3. Read the Basics and Choose a CMS Quick Start Guide:

Having trouble? See our support options below. You might have trouble if another local development tool is already using port 80 or 443.

Partial Feature List

  • Quickly create multiple local web development environments based on code repositories.
  • Import database for a project you're working on.
  • Import upload files to match the project (e.g. Drupal's sites/default/files or WordPress's wp-content/uploads).
  • Pantheon integration - grab a Pantheon archive and work locally with the database and files.
  • Run commands within the docker environment using ddev exec.
  • View logs from the web and db containers.
  • Use ddev ssh to explore the linux environment inside the container.
  • List running projects with ddev list.
  • Snapshot databases with ddev snapshot.
  • Temporarily share your development website with other using ddev share.
  • Trusted HTTPS support

Just running ddev will show you all the commands.


We love to hear from our users and help them be successful with ddev. Support options include:

  • ddev Documentation and faq
  • ddev StackOverflow for support and frequently asked questions. We respond quite quickly here and the results provide quite a library of user-curated solutions.
  • ddev issue queue for bugs and feature requests
  • The gitter drud/ddev channel (it's easy to log in many different ways)
  • The #ddev channels in Drupal Slack, TYPO3 Slack for interactive, immediate community support.
  • ddev-contrib repo provides a number of vetted user-contributed recipes for extending and using ddev. Your contributions are welcome.
  • awesome-ddev repo has loads of external resources, blog posts, recipes, screencasts, and the like. Your contributions are welcome.
  • Twitter with tag #ddev will get to us, but it's not as good for interactive support, but we'll answer anywhere.

Additional Information

  • Contributing See the "How can I contribute" question in the FAQ.
  • Version History: See DDEV's version history to browse through all the features that have been added.
  • Roadmap: Take a look at the milestones in the ddev issue queue to get an understanding of what's prioritized and what's next. We love your input! Make requests in the issue queue (if your request doesn't exist yet).