How to Set Up Drupal with Docker Using DDEV

A comprehensive guide to setting up Drupal with Docker using DDEV. Follow these step-by-step instructions to get your Drupal site up and running with ease.

Prerequisites

Before you begin, make sure you have the following tools installed on your machine:

• Docker: Download and install Docker from the official Docker website.
• DDEV: Install DDEV by following the DDEV installation guide.

Step-by-Step Guide

1. Create a New Directory for Your Drupal Project

mkdir my-drupal-site
cd my-drupal-site

2. Initialize DDEV in Your Project Directory

ddev config

When prompted:

• Project name: my-drupal-site (or your preferred name)
• Docroot location: web (default for Drupal 8+)
• Project type: drupal9 (or drupal8 depending on your needs)

3. Download Drupal

You can download Drupal manually or use Composer. For Composer:

ddev composer create drupal/recommended-project

This will set up a new Drupal project in the web directory.

5. One-time Initialization of mkcert

To enable HTTPS for your local development environment, you need to install mkcert. Run the following command:

mkcert -install

This will create a local certificate authority (CA) and install the CA in your system's trust store.

6. Start DDEV

ddev start

DDEV will create and start the necessary Docker containers for your project.

7. Install Drupal

Open your browser and go to http://my-drupal-site.ddev.site (replace my-drupal-site with your project name if different). This will take you to the Drupal installation page.

Follow the on-screen instructions to complete the Drupal installation:

• Database settings: Use the following credentials provided by DDEV:
• Database name: db
• Username: db
• Password: db
• Host: db

8. Access Your Drupal Site

Once the installation is complete, you can access your Drupal site at http://my-drupal-site.ddev.site.

Additional Configuration

Here are some additional configurations you might find useful:

• PHPMyAdmin: Access PHPMyAdmin at http://my-drupal-site.ddev.site:8036 for database management.
• MailHog: Access MailHog at http://my-drupal-site.ddev.site:8025 for email testing.

Managing Your Drupal Project

Here are some useful commands for managing your Drupal project with DDEV:

• Stop DDEV:

  ddev stop

• Remove DDEV Project:

  ddev delete

• Connect via SSH:

  ddev ssh

This guide should help you get your Drupal site up and running with Docker using DDEV. If you have any specific requirements or run into any issues, feel free to ask!

Published By: Krishanu Jadiya
Updated at: 2024-07-29 21:36:05