ddev is an open source tool that makes it dead simple to get local PHP development environments up and running within 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.
- Docker version 17.05 or greater
- OS Support
- macOS Sierra and higher (macOS 10.12 and higher)
- Linux (See Linux notes)
- Ubuntu 16.04 LTS
- Debian Jessie
- Fedora 25
- Windows 10 Pro
We are open to expanding this list to include additional OSs as well as improve our existing support for the ones listed above. Please let us know if you hit an issue!
Using ddev with other development environments
ddev requires ports 80 and 3306 to be available for use on your system when sites are running. If you are using another local development environment alongside ddev, please ensure the other environment is turned off or otherwise not occupying ports 80 and 3306.
If you need to use another environment after using ddev, simply ensure all of your ddev sites are stopped or removed. ddev only occupies system ports when at least one site is running.
Homebrew - macOS
For macOS users, we recommend downloading and installing ddev via homebrew:
brew tap drud/ddev && brew install ddev
Later, to upgrade to a newer version of ddev, simply run:
brew upgrade ddev
Installation Script - Linux and macOS
Linux and macOS end-users can use this line of code to your terminal to download, verify, and install ddev using our install script:
curl https://raw.githubusercontent.com/drud/ddev/master/install_ddev.sh | bash
Manual Installation - Linux and macOS
You can also easily perform the installation manually if preferred:
- Download and extract the latest ddev release for your architecture.
- Make ddev executable:
chmod ugo+x ddev
- Move ddev to /usr/local/bin:
mv ddev /usr/local/bin/(may require sudo), or another directory in your
ddevto test your installation. You should see ddev's command usage output.
Manual Installation - Windows
- Download and extract the latest ddev release for Windows.
%HOMEPATH%\AppData\Local\Microsoft\WindowsApps, or otherwise add
ddev.exeto a folder defined in your
ddevfrom a Command Prompt or PowerShell to test your installation. You should see ddev's command usage output.
If you've encountered trouble using ddev, please use these resources to get help with your issue:
- Please review the ddev Documentation to ensure your question isn't answered there.
- Review the ddev issue queue to see if an issue similar to yours already exists.
- If you've exhausted these options and still need help, please file an issue following the pre-populated guidelines and our Contributing Guidelines as best as possible.