github.com/ddev/ddev@v1.23.2-0.20240519125000-d824ffe36ff3/docs/content/users/install/ddev-upgrade.md (about)

     1  # Upgrading DDEV
     2  
     3  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.
     4  
     5  === "macOS"
     6  
     7      ## macOS
     8  
     9      ### Homebrew
    10  
    11      ```bash
    12      # Upgrade DDEV to the latest version
    13      brew upgrade ddev/ddev/ddev
    14      ```
    15  
    16      ### Install Script
    17  
    18      ```bash
    19      # Download and run the script to replace the DDEV binary
    20      curl -fsSL https://ddev.com/install.sh | bash
    21      ```
    22  
    23      ??? "Need a specific version?"
    24          Use the `-s` argument to specify a specific stable or prerelease version:
    25  
    26          ```bash
    27          # Download and run the script to update to DDEV v1.21.4
    28          curl -fsSL https://ddev.com/install.sh | bash -s v1.21.4
    29          ```
    30  
    31  === "Linux"
    32  
    33      ## Linux
    34  
    35      ### Debian/Ubuntu
    36  
    37      ```bash
    38      # Update package information and all packages including DDEV
    39      sudo apt update && sudo apt upgrade
    40      ```
    41  
    42      ### Fedora, Red Hat, etc.
    43  
    44      ```bash
    45      # Upgrade the DDEV package
    46      sudo dnf upgrade ddev
    47      ```
    48  
    49      ### Arch Linux
    50  
    51      ```bash
    52      # Upgrade the DDEV package
    53      yay -Syu ddev-bin
    54      ```
    55  
    56  === "Windows"
    57  
    58      ## Windows
    59  
    60      ### WSL2 + Docker
    61  
    62      If you’re using WSL2, the upgrade process is the same regardless of how you installed DDEV.
    63  
    64      Open the WSL2 terminal, for example “Ubuntu” from the Windows start menu, and run the following:
    65  
    66      ```bash
    67      # Upgrade the DDEV package
    68      sudo apt update && sudo apt upgrade -y
    69      ```
    70  
    71      ### Traditional Windows
    72  
    73      #### Chocolatey
    74  
    75      ```bash
    76      # Turn off DDEV and upgrade it
    77      ddev poweroff && choco upgrade ddev
    78      ```
    79  
    80      #### Installer
    81  
    82      Download and run the Windows installer for the latest [DDEV release](https://github.com/ddev/ddev/releases) (`ddev_windows_installer.<version>.exe`).
    83  
    84  === "Gitpod"
    85  
    86      ## Gitpod
    87  
    88      ```bash
    89      # Update package information and all packages including DDEV
    90      sudo apt update && sudo apt upgrade -y
    91      ```
    92  
    93  === "Codespaces"
    94  
    95      ## GitHub Codespaces
    96  
    97      ```bash
    98      # Update package information and all packages including DDEV
    99      sudo apt update && sudo apt upgrade -y
   100      ```
   101  
   102  === "Manual"
   103  
   104      ## Manual
   105  
   106      Upgrade using the exact same [manual install](./ddev-installation.md#manual) process:
   107  
   108      * Download and extract the latest [DDEV release](https://github.com/ddev/ddev/releases) for your architecture.
   109      * Move `ddev` to `/usr/local/bin` with `mv ddev /usr/local/bin/` (may require `sudo`), or another directory in your `$PATH` as preferred.
   110      * Run `ddev --version` to confirm you’re running the expected version.