README.md

---

Get started

1. 💻 Check that DDEV runs where you work: macOS, Windows 11, WSL2, Linux, and GitHub Codespaces. See the system requirements.
2. 📥 Install a Docker provider and DDEV.
3. 🏁 Follow a quickstart guide for your CMS or framework, then run ddev start.

ddev.com/get-started is the up-to-date getting-started guide. Or try DDEV without installing anything:

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

Sponsor DDEV

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.

License

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