DDEV in 10 Minutes on Linux
Learn how to set up DDEV on a fresh Ubuntu Linux system from scratch in about 10 minutes. This tutorial covers installing Docker CE, DDEV, creating a Drupal 11 project,
and configuring Xdebug with PhpStorm for step debugging.
Timeline:
0:00 - Introduction
Setting up DDEV on Linux from start to finish
0:30 - Install Docker CE
Visit https://ddev.com/get-started
Follow Docker installation instructions
Configure apt repository and install docker-ce
1:47 - Docker Post-Installation
Add user to docker group
Use `newgrp docker` to apply changes without reboot
Verify with `docker ps`
2:34 - Install DDEV
Copy installation commands from https://ddev.com/get-started
Install via apt repository
Verify with `ddev --version`
3:20 - Configure HTTPS Certificates
Run `mkcert -install` to enable trusted HTTPS
Allows browsers to accept DDEV certificates
3:45 - Create Project
Clone Drupal 11 project to workspace directory
Run `ddev config` (auto-detects docroot and project type)
Run `ddev start` to start project (does one-time download of Docker images)
5:00 - Project Startup
DDEV builds customized images with user ID
Automatic ddev composer install via hook
6:52 - Launch Project
Run `ddev launch` to open in browser
Drupal installation screen with trusted HTTPS
Complete Drupal installation
8:10 - Install PhpStorm
Install via Snap: `sudo snap install --classic phpstorm`
Open project in PhpStorm
Configure project directory
10:56 - Configure Xdebug
Set breakpoint in web/index.php
Click "Start listening for PHP debug connections"
Run `ddev xdebug on`
12:14 - Test Step Debugging
Visit site in browser to trigger breakpoint
Map container paths to local paths (first-time setup)
Successfully debug with variable inspection and step-through
13:19 - Recap
Installed Docker, DDEV, and PhpStorm
Created and configured Drupal 11 project
Set up Xdebug step debugging
All on a fresh Ubuntu system in ~13 minutes
Links:
Get Started: https://ddev.com/get-started
Documentation: https://docs.ddev.com
Project: https://github.com/ddev/ddev
DDEV Website: https://ddev.com
Join Discord: https://ddev.com/s/discord