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.

!!!tip "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"

## macOS

### Homebrew (Most Common)

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

### Install Script (Unusual)

```bash
# 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](../usage/faq.md#why-do-i-have-an-old-ddev).

??? "Need a specific version?"
    Use the `-s` argument to specify a specific stable or prerelease version:

    ```bash
    # 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"

## Linux

### Debian/Ubuntu (including WSL2)

```bash
# 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.

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

### Arch Linux

```bash
# 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](../usage/faq.md#why-do-i-have-an-old-ddev).

=== "Windows"

## 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:

```bash
# 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](#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](../usage/faq.md#why-do-i-have-an-old-ddev).

### Traditional Windows

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

<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 1rem; text-align: center;">
[Download for AMD64 :material-microsoft-windows:<br>(Intel/AMD) :material-download:](https://ddev.com/download/ddev_windows_amd64_installer.exe "For computers with Intel or AMD processors (most common)"){ .md-button .md-button--primary }
[Download for ARM64 :material-microsoft-windows:<br>(Snapdragon) :material-download:](https://ddev.com/download/ddev_windows_arm64_installer.exe "For computers with ARM processors like Qualcomm Snapdragon"){ .md-button .md-button--primary }
</div>

- **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

!!!tip "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.

??? tip "Upgrade using WinGet"
    ```powershell
    winget upgrade --interactive DDEV
    ```

??? tip "Upgrade using Chocolatey (Traditional Windows AMD64 only)"
    ```powershell
    choco upgrade ddev
    ```

=== "Codespaces"

## GitHub Codespaces

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

=== "Manual"

## Manual

Upgrade using the exact same [manual install](./ddev-installation.md#manual) process:

* Download and extract the latest [DDEV release](https://github.com/ddev/ddev/releases) 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.