Skip to content

Get Started with DDEV

DDEV is an open source tool for launching local PHP development environments in minutes.

These environments can be extended, version controlled, and shared, so you can take advantage of a Docker workflow without Docker experience or bespoke configuration. Projects can be changed, powered down, or removed just as easily as they’re started.

System Requirements


Runs natively on ARM64 (Apple Silicon) and AMD64 machines.

  • RAM: 8GB
  • Storage: 256GB
  • Colima or Docker Desktop
  • Colima and Docker Desktop both require macOS Big Sur (11) or higher.
  • On macOS with either Colima or Docker Desktop most users will want to enable Mutagen for best performance, ddev config global --mutagen-enabled

Windows WSL2

  • RAM: 8GB
  • Storage: 256GB
  • Docker Desktop on the Windows side or Docker CE inside WSL2
  • Ubuntu or an Ubuntu-derived distro is recommended, though others may work fine

Traditional Windows

  • Any recent edition of Windows Home or Windows Pro.
  • RAM: 8GB
  • Storage: 256GB
  • Docker Desktop using the WSL2 backend


Most distros and most versions work fine, on both AMD64 and ARM64 architectures.

  • RAM: 8GB
  • Storage: 256GB

Gitpod and GitHub Codespaces

With Gitpod and GitHub Codespaces you don’t install anything; you only need a browser and an internet connection.

Last update: March 5, 2023