# Docker + Compose + Buildx Upgrade Guide

Process: remove old version → install new version → verify

---

# 1. Remove Old Version

## Remove apt-installed packages

```bash
sudo apt remove -y docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc
```

---

## Remove system `docker-compose` (V1)

```bash
sudo rm -f "$(which docker-compose 2>/dev/null)"
```

---

## Find and remove manually installed Buildx plugin

```bash
docker info | sed -n '/Plugins:/,/^ Server:/p' | grep -A2 buildx
```

Get the `Path` from the output, then run:

```bash
rm -f <path to docker-buildx file>
```

---

## Clean up unused dependencies

```bash
sudo apt autoremove -y
```

---

# 2. Install Official Docker

Includes Docker Engine, Docker Compose plugin, and Docker Buildx plugin.

## Install dependencies

```bash
sudo apt update
sudo apt install -y ca-certificates curl gnupg
```

---

## Add Docker GPG key

```bash
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
  sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
```

---

## Add official repository

```bash
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```

---

## Install Docker + Compose + Buildx

```bash
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```

---

# 3. Verify Installation

```bash
docker --version
docker compose version
docker buildx version
```

---

# 4. Common Commands

```bash
docker compose up -d
docker compose down
docker buildx build .
```