Install Drupal using DDEV for local development | Installing Drupal | Drupal Wiki guide on Drupal.org
Skip to search
Can we use first and third party cookies and web beacons to
understand our audience, and to tailor promotions you see
Documentation
Advertising sustains the DA. Ads are hidden for members.
Join today
On this page
Introduction to DDEV
Install DDEV
Install Drupal
Option 1. Using Composer
Option 2. Using Git with clone
Info and support
Installing Drupal
Before installation
Install Drupal using DDEV for local development
Install dependencies with Composer
Create a database
Run the installer
Status check
Add Composer to an existing site
Drupal Quick Start
Trusted Host settings
Using a load balancer or reverse proxy
Install Drupal using DDEV for local development
Last
updated
on
24 April 2026
Introduction to DDEV
The Drupal community selected
DDEV
as the recommended local development environment in June 2024. DDEV is an open source docker-based tool for creating local web development projects in minutes. Drupal is one of many projects that DDEV supports.
Like Drupal, DDEV depends on the support of the open source community.
Learn how to support DDEV
Install DDEV
The following instructions to setup DDEV for working with Drupal links to the DDEV documentation.
Check requirements
Confirm that your system meets the requirements listed in the
DDEV system requirements
Install Docker
Go to
Docker installation
, select your environment and follow the instructions. If
installing DDEV on Docker Engine on WSL2 on Windows
, the DDEV installation script will handle Docker installation.
Install DDEV
Go to
DDEV installation
, select your environment and follow the instructions.
Install Drupal
Drupal can be downloaded using Composer or with a Git clone of Drupal core. Downloading with composer is the recommended method for most projects. Using a Git clone is typically used for
contributing to Drupal core
Option 1. Using Composer
Go to the
Drupal section
of the CMS Quickstarts and follow the instructions.
Congratulations! The latest official release of Drupal is now installed and open in your default browser. Also installed is
Drush
, the command line shell for working with Drupal.
Option 2. Using Git with
clone
Get the development version per the
Drupal core version control
instructions
If you want to develop on Drupal core (e.g., fix bugs or issues in Drupal core), use the following command:
git clone https://git.drupalcode.org/project/drupal.git
Make sure to go to the Drupal directory:
cd drupal
Create the DDEV project:
ddev config --project-type drupalN
where
is the version of Drupal you want to use.
Start the project:
ddev start
Get the external dependencies for Drupal core:
ddev composer install
Install Drush, the command line tool for working with Drupal:
ddev composer require drush/drush
Install Drupal using drush:
ddev drush site:install -y
Launch your new Drupal site in a new tab of your default browser:
ddev launch
... or automatically log into the
admin account
ddev launch $(ddev drush uli)
Congratulations! The latest snapshot of Drupal's development version (the
main
branch) is now installed and open in your default browser. You can now
test Drupal patches and merge requests
Info and support
Read
Getting Started with DDEV
(January 2026) for an introduction and the
DDEV blog
, for regular updates.
For support, there is
support from the DDEV project
and in
Drupal Slack
there are the #ddev and the #ddev-for-core-dev channels.
Help improve this page
Page status:
No known problems
You can:
Log in, click
Edit
, and edit this page
Log in, click
Discuss
, update the Page status value, and suggest an improvement
Log in and
create a Documentation issue
with your suggestion
Drupal’s online documentation is © 2000-2026 by the individual contributors and can be used in accordance with the
Creative Commons License, Attribution-ShareAlike 2.0
. PHP code is distributed under the
GNU General Public License
Infrastructure management for Drupal.org provided by
Need a Drupal 7 extended support partner? Consider Tag1.
News items
News
Planet Drupal
Social media
Sign up for Drupal news
Security advisories
Jobs
Our community
Community
Services
Training
Hosting
Contributor guide
Groups & meetups
DrupalCon
Code of conduct
Documentation
Documentation
Drupal Guide
Drupal User Guide
Developer docs
API.Drupal.org
Drupal code base
Download & Extend
Drupal core
Modules
Themes
Distributions
Governance of community
About
Web accessibility
Drupal Association
About Drupal.org
Drupal is a
registered trademark
of
Dries Buytaert