Skip to content

Upgrading DDEV

Installing and upgrading DDEV are nearly the same thing, because you’re upgrading the ddev binary that talks with Docker. You can update this file like other software on your system, whether it’s with a package manager or traditional installer.

ddev --version shows an old version

If you have installed or upgraded DDEV to the latest version, but when you check the actual version with ddev --version, it shows an older version, please refer to Why do I have an old DDEV?

macOS

Homebrew (Most Common)

# Upgrade DDEV to the latest version
brew update && brew upgrade ddev/ddev/ddev

Install Script (Unusual)

# Download and run the script to replace the DDEV binary
curl -fsSL https://ddev.com/install.sh | bash

Verify New Version

Use ddev --version to find out the version of the ddev binary in your $PATH. If ddev --version still shows an older version than you installed or upgraded to, use which -a ddev to find out where another version of the ddev binary must be installed. See the “Why Do I Have An Old DDEV” FAQ.

Need a specific version?

Use the -s argument to specify a specific stable or prerelease version:

# Download and run the script to update to DDEV v1.24.10
curl -fsSL https://ddev.com/install.sh | bash -s v1.24.10

Linux

Debian/Ubuntu (including WSL2)

# Update package information and ddev package
sudo apt-get update && sudo apt-get install --only-upgrade ddev

# If you are using WSL2, also upgrade the ddev-wsl2 package
sudo apt-get update && sudo apt-get install --only-upgrade ddev ddev-wsl2

Fedora, Red Hat, etc.

# Upgrade the DDEV package
sudo dnf upgrade --refresh ddev

Arch Linux

# Upgrade the DDEV package
yay -Syu ddev-bin

Verify New Version

Use ddev --version to find out the version of the ddev binary in your $PATH. If ddev --version still shows an older version than you installed or upgraded to, use which -a ddev to find out where another version of the ddev binary must be installed. See the “Why Do I Have An Old DDEV” FAQ.

Windows

WSL2 + Docker

If you’re using WSL2, the upgrade process is the same regardless of how you installed DDEV.

Open the WSL2 terminal, for example “Ubuntu” from the Windows start menu, and run the following:

# Update package information and ddev packages
sudo apt-get update && sudo apt-get install --only-upgrade ddev ddev-wsl2

You can also download and run the DDEV Windows Installer again (see Traditional Windows below), and it will do the upgrade for you. Make sure to choose the type of installation you have (Docker CE or Docker/Rancher Desktop).

Verify New Version

Use ddev --version to find out the version of the ddev binary in your $PATH. If ddev --version still shows an older version than you installed or upgraded to, use which -a ddev to find out where another version of the ddev binary must be installed. See the “Why Do I Have An Old DDEV” FAQ.

Traditional Windows

Download the installer — make sure to pick the right architecture:

  • AMD64 (x86-64): Most traditional Windows PCs (Intel/AMD processors)
  • ARM64: Windows on ARM devices like Microsoft Surface Pro X, Surface Pro 9 (5G), or other ARM-based Windows devices

Check your system architecture

Not sure which architecture you have? Open PowerShell and run: $env:PROCESSOR_ARCHITECTURE. It will show AMD64 or ARM64. Alternatively, in WSL2/Ubuntu run uname -m which shows x86_64 for AMD64 or aarch64 for ARM64.

Run the installer and follow the prompts to complete the upgrade.

Upgrade using WinGet 
winget upgrade --interactive DDEV
Upgrade using Chocolatey (Traditional Windows AMD64 only) 
choco upgrade ddev

GitHub Codespaces

# Update package information and ddev package
sudo apt-get update && sudo apt-get install --only-upgrade ddev

Manual

Upgrade using the exact same manual install process:

  • Download and extract the latest DDEV release for your architecture.
  • Move ddev to /usr/local/bin with mv ddev /usr/local/bin/ (may require sudo), or another directory in your $PATH as preferred.
  • Run ddev --version to confirm you’re running the expected version.