2026 Community Survey results are here! See how the Craft CMS community works. results are live!

How to Install DDEV on macOS

We'll install DDEV using the official Homebrew method.

If you haven’t yet installed Dock­er Desk­top on your local machine, please do the pre­vi­ous step first. Oth­er­wise, noth­ing will work! 

We are going to use Home­brew to install DDEV. If you don’t already have Home­brew installed, check out the offi­cial doc­u­men­ta­tion on installing Home­brew.

brew install drud/ddev/ddev

DDEV han­dles all self-signed, local­ly trust­ed SSL cer­tifi­cates, so you can run secure con­nec­tions on named hosts local­ly. To get this work­ing, we need to run the mkcert com­mand to install the certificates. 

mkcert is a util­i­ty that han­dles the process of cre­at­ing trust­ed cer­tifi­cates. No messy set­up or configuration!

mkcert -install

Let’s con­firm that DDEV is run­ning as we expect. To do that, we’ll run a ddev com­mand check the output.

ddev version

This should out­put some infor­ma­tion about the DDEV ver­sion installed, includ­ing oth­er sup­port­ing software.

Craft Version
Craft 4, Craft 5
Topic
Instructor
Ryan Irelan
Level
Beginner
Date Published
June 14, 2022
Ryan Irelan

I am the creator of CraftQuest, a web developer, and former software team manager. I spend most of my time improving CraftQuest with code and courses. When I'm not in front of the computer, I spend my time with my family, and running on the roads and trails of Austin, TX.