DDEV-Local: a local PHP development environment system
Clone or download
Failed to load latest commit information.
.buildkite Explicitly support mariadb upgrade from 10.1 to 10.2 (#1160) Oct 9, 2018
.circleci Add content tests in TestDdevFullSiteSetup, fixes #677 (#1155) Oct 8, 2018
.githooks Add staticrequired to pre-push hooks (#1045) Aug 13, 2018
.github Use new issue templates for ddev (#826) May 14, 2018
.vscode Local test refactor, fixes #371, fixes #381 (#383) Jul 10, 2017
build-tools Bump build-tools to get golang v1.11 (#1122) Sep 24, 2018
cmd Add config flags to specify image values, closes #1181 (#1182) Oct 14, 2018
containers Add openssh-client to web container for #414 (#1217) Oct 18, 2018
docs Add a link to docker-for-windows (#1215) Oct 16, 2018
images Adding ddev logo to readme. (#432) Aug 9, 2017
pkg Better error handling when opening/writing config files, fixes #1177 (#… Oct 19, 2018
testing updates and fixes for perf test (#389) Jul 10, 2017
vendor Make ddev_drush_settings.php actually work on host, fixes #454 (#1036) Aug 14, 2018
winpkg Provide descriptions for Windows installer components, fixes #903 (#904) Jun 8, 2018
.dockerignore Switching to managing dependencies with govendor. (#142) Sep 29, 2016
.gitignore Add windows 10 docker toolbox testing to buildkite, fixes #705 (#902) Jun 7, 2018
CONTRIBUTING.md Reorganize docs and setup documentation site (#234) May 19, 2017
Gopkg.lock Make ddev_drush_settings.php actually work on host, fixes #454 (#1036) Aug 14, 2018
Gopkg.toml Update dep dependencies to more current versions (#1003) Jul 20, 2018
LICENSE Change license from MIT to Apache 2.0 (#422) Aug 2, 2017
Makefile Use faster golangci-lint only, less linting (build/test only) (#1178) Oct 12, 2018
README.md Update docs for Windows 10 Home and Enterprise, update min docker ver… Jul 5, 2018
install_ddev.sh Use command instead of which in install script, fixes #1114 (#1119) Sep 25, 2018
mkdocs.yml Add docker installation and testing instructions (#1041) Aug 13, 2018
nightly_build.mak Fix nightly_build.mak after container name change (#995) Jul 17, 2018



CircleCI Go Report Card project is maintained

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-ce (ddev requires Docker and docker-compose). (more info here).
  2. Install ddev: Options include macOS homebrew (recommended), an install script, or manual installation.
  3. 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.

Current Feature List

  • Quickly create multiple local web development environments based on a 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.

Just running ddev will show you all the commands.


If you're having trouble using ddev, please use these resources to get help:

  1. See the ddev Documentation.
  2. Review Stack Overflow DDEV-Local questions and answers (or ask a question there! We get notified when you ask.)
  3. The ddev issue queue may have an issue related to your problem.
  4. For suspected bugs or feature requests, file an issue.
  5. The #ddev channel in Drupal Slack and TYPO3 Slack for interactive, immediate community support


Interested in contributing to ddev? We would love your suggestions, contributions, and help! Please review our Guidelines for Contributing, then create an issue or open a pull request!

Addititional Information