Get Started with DDEV

Ready to get started? Follow this guide to create local PHP web development environments quickly with DDEV. (This is a super-quick overview, you’ll probably want to go to the docs, which have more detail.) 

Step 1. Install DDEV

  1. Install a Docker provider for your environment.
  2. Install DDEV for your environment.

To see which ddev commands are available, check the manual pages: ddev or

ddev -h

Tip: If you’re already running a webserver on port 80, follow troubleshooting steps to resolve port conflicts.

Step 2. First-time project setup

Check out the existing site repository to a local directory. This is the project directory.

Set up a project for the first time with ddev config. You only need to do this once per project. To set up a new project, answer three questions:

  • What’s site name?
  • What’s the location of the docroot?
  • What type of project is it? Such as Drupal, PHP, WordPress, etc.

Follow the configuration examples for the CMS you’re working within the Quickstart Guides in the documentation.

Depending on the CMS, and whether the project is a brand new site or an existing one, DDEV attempts to make the CMS-specific settings files.

If you’re working with an existing project follow the steps to import the database. Then, run ddev describe to get the database credentials for the project.

This was a one-time configuration, and configuration files were created for the project. Take a look at the project’s .ddev/config.yaml file.

Step 3. Use DDEV every day

To see a list of the current DDEV projects type ddev list. The terminal will display what projects are configured, their status, and a link to access each project.

Start your project

Each time you want to work on a project run ddev start from the project directory. Or, to start any project, from anywhere, run:

ddev start projectname

It’s the same with other DDEV CLI commands. Run them directly from within the project (docroot), or specify the project name from anywhere.

Done working? Remove the container.

When you’re done with your tasks, remove the project while maintaining the database and keeping the state of the project intact without using up resources:

ddev stop

Because ddev stop is not destructive (it maintains the database) it makes starting up next time much easier. So that means, to start this project type ddev start projectname, or cd into the project directory and typeddev start.

If you do need to wipe out the database and erase DDEV’s memory of the project

ddev delete

Step 4. Stay up-to-date

From this point on, when you need to update DDEV follow the instructions under the installation guide.

Join the DDEV Community

DDEV is an open source project, with a growing community.

View all the options for support in the DDEV documentation.

Find a bug? Have a feature proposal? Visit the issue queue on GitHub.