ddev - Docker-based local PHP+Node.js web development environments

Docker-based local development environments, ready in minutes

Get the power of Docker without needing to know Docker. Start PHP and Node.js projects in minutes, run many projects at the same time, and spend less time on setup.

Get Started · Documentation · Quickstarts · Add-on Registry · Contributing · Sponsor

Get started

The quickest path is the Get Started guide: pick your operating system and it gives you the install commands and your first project, on one page.

If you'd rather read the full instructions:

💻 Check that DDEV runs where you work: macOS, Windows 11, WSL2, Linux, and GitHub Codespaces. See the system requirements.
📥 Install a Docker provider and DDEV: follow the install instructions.
🏁 Start your first project: pick a quickstart guide for your CMS or framework, then run ddev start.

Want to try DDEV first? Run it in your browser, nothing to install:

Why DDEV?

DDEV takes care of Docker for you, so you and your team can focus on your work. It comes with good defaults for everyday use, and you can change them when you need more.

🚀 Ready in minutes: good defaults and little setup. Just run ddev start.
📦 One setup per project: keep it in Git and share the same environment with your whole team.
🔧 Your stack, your choice: PHP 5.6 through 8.5, Nginx or Apache, and MariaDB, MySQL, or PostgreSQL, per project. And any version of Node.js you need.
🧩 Easy to extend: a growing set of add-ons for extra services and integrations, and custom commands are ordinary shell scripts.
🖥️ Runs everywhere: macOS, Windows, WSL2, Linux, and GitHub Codespaces, on both ARM64 and AMD64.
🔒 Included out of the box: trusted HTTPS, Xdebug, database snapshots, and hosting integrations with Upsun (formerly Platform.sh), Pantheon, Acquia, and others.
💙 Run by the community: free and open source, cared for by the nonprofit DDEV Foundation.

Everyday commands

ddev start and ddev stop: run or pause a project's containers
ddev import-db and ddev import-files: load a database dump, or user-upload files such as Drupal sites/default/files and WordPress wp-content/uploads
ddev snapshot: save and restore database state
ddev exec and ddev ssh: run a command inside the web container, or open a shell in it
ddev logs and ddev list: read container logs, or see every project on the machine
ddev share: hand someone a temporary public URL for your local site

Run ddev for the full command reference.

Community and support

💬 Discord: the fastest way to get help and talk to the maintainers
🧭 Support: every place the friendly community answers questions
🐛 Issues: report bugs and ask for new features
📚 Documentation: guides, references, and how-tos
📣 Blog: news, releases, and community updates

Contributing

🙋 “How can I contribute to DDEV?” in the FAQ: all the ways to help, code or not
📄 Contributing: issues, pull requests, and Stack Overflow
🛠️ Building, Testing, and Contributing: build the binary and run the tests

DDEV is free and open source, maintained by the nonprofit DDEV Foundation and paid for by its community. If DDEV saves you time, please consider sponsoring the project. Sponsorships fund the maintainers and infrastructure, and keep DDEV independent.

In-kind sponsors

DDEV depends on products and services provided free of charge by the generous companies below. Thanks!

Sponsor	Contribution
	Linux package repository hosting is graciously provided by Cloudsmith. Cloudsmith is the only fully hosted, cloud-native, universal package management solution, that enables your organization to create, store and share packages in any format, to any place, with total confidence.
	JetBrains provides DDEV maintainers with licenses for its IDEs.
	MacStadium provides a cloud-hosted Apple silicon machine that DDEV uses for testing.

License

DDEV is licensed under the Apache License 2.0. See LICENSE.