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?

macOSLinuxWindowsCodespacesManual

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, 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 and run the Windows installer (for your architecture, most often AMD64) for the latest DDEV release (ddev_windows_<architecture>_installer.<version>.exe).

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.