Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
45 changes: 23 additions & 22 deletions src/content/blog/watch-ddev-local-from-scratch-with-macos.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
---
title: "Watch: DDEV From Scratch with macOS"
pubDate: 2020-08-13
modifiedDate: 2025-10-06
pubDate: 2026-05-06
#modifiedDate: 2026-05-04
summary: Screencast guide to running DDEV on macOS.
author: Randy Fay
featureImage:
src: /img/blog/2020/08/screen-shot-2020-08-04-at-5.33.27-pm.png
alt: Screen grab of video's title frame
hide: true
src: /img/blog/2026/05/DDEV-from-scratch-on-macOS.jpg
alt: Screen grab of DDEV from Scratch on macOS video title frame
categories:
- Guides
- Videos
Expand All @@ -16,31 +15,33 @@ categories:
> **Using Windows or Linux?** See [DDEV on Windows in 10 Minutes](watch-new-windows-installer.md), [DDEV on WSL2 from Scratch](watch-ddev-local-from-scratch-with-windows-wsl2.md), or [DDEV on Linux in 10 Minutes](ddev-on-linux-in-10-minutes.md).

<div class="video-container">
<iframe loading="lazy" title="DDEV from Scratch on macOS" width="500" height="281" src="https://www.youtube.com/embed/-firvjLr2hE?feature=oembed" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen=""></iframe>
<iframe loading="lazy" title="DDEV from Scratch on macOS" width="500" height="281" src="https://www.youtube.com/embed/XHUR4VWPfU8?feature=oembed" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen=""></iframe>
</div>

[DDEV](https://github.com/ddev/ddev) is a local development environment based on Docker containers that gets you up and working on your project fast. Configuring Docker for local development performance is no longer a dark art when all the benefits are wrapped in a user friendly tool like DDEV. When you’re ready for [additional configuration and customization](https://docs.ddev.com/en/stable/users/extend/customization-extendibility/#extending-and-customizing-environments), you wont be starting from scratch with your docker-compose.yaml and can lean on [the expertise of the DDEV community](https://docs.ddev.com/en/stable/users/support/).
[DDEV](https://github.com/ddev/ddev) is a local development environment based on Docker containers that gets you up and working on your project fast. When you’re ready for [additional configuration and customization](https://docs.ddev.com/en/stable/users/extend/customization-extendibility/), you won’t be starting from scratch and can lean on [the expertise of the DDEV community](https://docs.ddev.com/en/stable/users/support/).

In this screencast I’ll walk you through the first time set up of Docker, Homebrew, some initial configuration and optimization you might consider, and getting started with a basic project. We’ll use a Composer-managed [Drupal 9 project](https://docs.ddev.com/en/stable/users/quickstart/#drupal) as an example, but we have a handful of quickstart recipes for other CMSs not to mention a huge variety of PHP projects and more that will happily run in DDEV.
In this screencast we walk through installing Homebrew, setting up OrbStack as a Docker provider, installing DDEV, and getting started with a basic project — all on a brand-new MacBook Neo with only 8GB of RAM. We use a Composer-managed [Drupal 11 project](https://docs.ddev.com/en/stable/users/quickstart/#drupal) as an example, and also cover setting up Xdebug with both PhpStorm and VS Code. The [presentation slides](https://docs.google.com/presentation/d/14PqtS_CQFJihVS1W_St_BJNIixz4H7cHXqqcmSwxl-I/edit) are also available.

After watching this tutorial, you’ll be able to run websites on your computer with no configurations needed and have hundreds of sites with different configurations available locally, all because Docker does the heavy lifting, while DDEV does the simplifying. Whether you’re a solo engineer, or a member of a team, DDEV will help you to be more efficient. After all, we’re all about [Advancing Developer Communities](/about/).
After watching this tutorial, you’ll be able to run websites on your computer with minimal configuration and have multiple sites with different configurations available locally, all because Docker does the heavy lifting while DDEV does the simplifying. Whether you’re a solo engineer or a member of a team, DDEV will help you be more efficient.

**This screencast references the regular [DDEV documentation](https://docs.ddev.com/):**

- [DDEV Installation with Homebrew](https://docs.ddev.com/en/stable/#homebrewlinuxbrew-macoslinux)
- [Using the CLI](https://docs.ddev.com/en/stable/users/cli-usage/)
- [Drupal 9 Quickstart](https://docs.ddev.com/en/stable/users/quickstart/#drupal)
- Support: Drupal Slack and TYPO3 Slack, Gitter, Stack Overflow: See [Support docs](https://docs.ddev.com/en/stable/users/support/).
- [DDEV Installation](https://docs.ddev.com/en/stable/users/install/ddev/)
- [Using the CLI](https://docs.ddev.com/en/stable/users/usage/cli/)
- [Drupal 11 Quickstart](https://docs.ddev.com/en/stable/users/quickstart/#drupal)
- [Step Debugging with Xdebug](https://docs.ddev.com/en/stable/users/debugging-profiling/step-debugging/)
- Support: [DDEV Discord](/s/discord), Drupal Slack `#ddev` channel: See [Support docs](https://docs.ddev.com/en/stable/users/support/)
- [DDEV Project Repository](https://github.com/ddev/ddev) and issue queue

**Here’s the video table of contents (opens in YouTube):**

- What is DDEV ([0:35](https://youtu.be/-firvjLr2hE?t=31))
- Install Homebrew (optional) ([2:27](https://youtu.be/-firvjLr2hE?t=147))
- Install Docker Desktop for Mac ([2:58](https://youtu.be/-firvjLr2hE?t=178))
- Install DDEV ([4:05](https://youtu.be/-firvjLr2hE?t=244))
- Enable NFS ([6:21](https://youtu.be/-firvjLr2hE?t=381))
- Create a trivial “junk” project ([9:15](https://youtu.be/-firvjLr2hE?t=555))
- Create a Drupal 9 project ([12:40](https://youtu.be/-firvjLr2hE?t=760))
- Learn a few DDEV commands ([17:10](https://youtu.be/-firvjLr2hE?t=1030))
- DDEV Resources ([19:42](https://youtu.be/-firvjLr2hE?t=1182))
- What is DDEV ([1:00](https://youtu.be/XHUR4VWPfU8?t=60))
- Install Homebrew ([3:01](https://youtu.be/XHUR4VWPfU8?t=181))
- Install Docker provider (OrbStack) ([5:07](https://youtu.be/XHUR4VWPfU8?t=307))
- Install DDEV ([7:54](https://youtu.be/XHUR4VWPfU8?t=474))
- Create a trivial "junk" project ([9:03](https://youtu.be/XHUR4VWPfU8?t=543))
- Create a Drupal 11 project ([11:42](https://youtu.be/XHUR4VWPfU8?t=702))
- Learn a few DDEV commands ([15:35](https://youtu.be/XHUR4VWPfU8?t=935))
- Xdebug with PhpStorm ([18:51](https://youtu.be/XHUR4VWPfU8?t=1131))
- Xdebug with VS Code ([24:40](https://youtu.be/XHUR4VWPfU8?t=1480))
- DDEV Resources ([30:40](https://youtu.be/XHUR4VWPfU8?t=1840))
Loading