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

     1  # Uninstalling DDEV
     2  
     3  A DDEV installation consists of:
     4  
     5  * The self-contained `ddev` binary.
     6  * Each project’s `.ddev` directory.
     7  * The global `~/.ddev` directory where various global items are stored.
     8  * The global `~/.ddev_mutagen_data_directory` directory where Mutagen sync data may be stored.
     9  * The associated Docker images and containers DDEV created.
    10  * Any entries in `/etc/hosts`.
    11  
    12  Please use [`ddev snapshot`](commands.md#snapshot) or [`ddev export-db`](commands.md#export-db) to make backups of your databases before deleting projects or uninstalling.
    13  
    14  You can use [`ddev clean`](commands.md#clean) to uninstall the vast majority of things DDEV has touched. For example, `ddev clean <project>` or `ddev clean --all`.
    15  
    16  To uninstall one project, run [`ddev delete <project>`](commands.md#delete). This removes any hostnames in `/etc/hosts` and removes your database. If you don’t want it to make a database backup/snapshot on the way down, include the `--omit-snapshot` option: `ddev delete --omit-snapshot <project>`.
    17  
    18  To remove all DDEV-owned `/etc/hosts` entries: [`ddev hostname --remove-inactive`](commands.md#hostname).
    19  
    20  To remove the global `.ddev` directory: `rm -r ~/.ddev`.
    21  
    22  To remove the global `.ddev_mutagen_data_directory` directory: `rm -r ~/.ddev_mutagen_data_directory`.
    23  
    24  If you installed Docker only for DDEV and want to uninstall it with all containers and images, uninstall it for your version of Docker.
    25  
    26  Otherwise:
    27  
    28  * Remove Docker images from before the current DDEV release with [`ddev delete images`](commands.md#delete-images).
    29  * Remove all DDEV Docker containers that might still exist: `docker rm $(docker ps -a | awk '/ddev/ { print $1 }')`.
    30  * Remove all DDEV Docker images that might exist: `docker rmi $(docker images | awk '/ddev/ {print $3}')`.
    31  * Remove all Docker images of any type (does no harm; they’ll be re-downloaded): `docker rmi -f $(docker images -q)`.
    32  * Remove any Docker volumes: `docker volume rm $(docker volume ls | awk '/ddev|-mariadb/ { print $2 }')`.
    33  
    34  To remove the `ddev` binary:
    35  
    36  * Find the binary location with `which -a ddev`, you may have several binaries installed in different ways. The output will give you a general idea of how you installed it.
    37  * On macOS or Linux with Homebrew, `brew uninstall ddev`.
    38  * For Linux or other simple installs, remove the binary. Example: `sudo rm /usr/local/bin/ddev`. For Linux installed via apt, `sudo apt remove ddev`.
    39  * On Windows, if you used the DDEV Windows installer, use the uninstall on the Start Menu or in the “Add or Remove Programs” section of Windows Settings.