Skip to content

Instantly share code, notes, and snippets.

@Marc-MMA

Marc-MMA/readme.md

Last active October 4, 2025 03:18
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save Marc-MMA/4bba9e383b65822cda3fa7ebe504733d to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save Marc-MMA/4bba9e383b65822cda3fa7ebe504733d to your computer and use it in GitHub Desktop.
Download ZIP
DDEV HTTPS SSL WSL2
Raw
readme.md

Enable HTTPS with DDEV on Windows + WSL2

This guide explains how to enable HTTPS support for DDEV on Windows using WSL2.

1. Install mkcert on Windows

  1. Open PowerShell as Administrator
  2. Install mkcert using Chocolatey: 
    choco install mkcert
    If mkcert is already installed, you can reinstall it with: 
    choco install mkcert --force
  3. Install the root certificate: 
    mkcert -install

2. Verify the certificate location

In PowerShell, run:

echo $env:LOCALAPPDATA\mkcert

This should return a path like:

C:\Users\your_username\AppData\Local\mkcert

3. Configure mkcert in WSL2

  1. Open a WSL2 terminal
  2. Set CAROOT to use Windows certificates: 
    export CAROOT=/mnt/c/Users/your_username/AppData/Local/mkcert
    Replace your_username with your Windows username.
  3. Make this configuration permanent: 
    echo 'export CAROOT=/mnt/c/Users/your_username/AppData/Local/mkcert' >> ~/.bashrc
source ~/.bashrc

4. Install certificates in WSL2

In WSL2, run:

mkcert -install

5. Restart DDEV

  1. Stop all DDEV projects: 
    ddev poweroff
  2. Restart a project: 
    ddev start

6. Test HTTPS

Open your project in the browser using https:// and verify that the certificate is recognized.

If you encounter any errors, ensure that mkcert -install has been executed both on Windows and WSL2.

@hugo-fasone
Copy link
Copy Markdown

hugo-fasone commented Oct 3, 2025 •
edited
Loading

Thank you for this procedure, works like a charm

@rfay
Copy link
Copy Markdown

rfay commented Oct 4, 2025

Note that DDEV now has a full installer that sets up mkcert and WSL2 just exactly as they should be set up, easy as pie.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment