Files
planet/docs/technical/en/ops-docker-compose-buildx-upgrade.md
2026-04-28 04:27:18 +08:00

1.8 KiB

Docker + Compose + Buildx Upgrade Guide

Process: remove old version → install new version → verify


1. Remove Old Version

Remove apt-installed packages

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

Remove system docker-compose (V1)

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

Find and remove manually installed Buildx plugin

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

Get the Path from the output, then run:

rm -f <path to docker-buildx file>

Clean up unused dependencies

sudo apt autoremove -y

2. Install Official Docker

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

Install dependencies

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

Add Docker GPG key

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

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

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

3. Verify Installation

docker --version
docker compose version
docker buildx version

4. Common Commands

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