RaspberrypiにDockerをインストールする

containers and cranes at hamburg port

2025/07時点での手順。忘れがちなので。

https://docs.docker.com/engine/install/debian/#install-using-the-repository

インストール前に競合パッケージの削除

for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove $pkg; done

Dockerのaptリポジトリ設定

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

インストール

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

インストールの確認

sudo docker run hello-world

忘れがちな権限設定

sudo usermod -aG docker $USER

# 上記の後はログアウトもしくは下記を実行

newgrp docker

上記をやらないと下記のエラーが発生する

docker compose up -d
unable to get image 'YOUR-PACKAGE-NAME': permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get "http://%2Fvar%2Frun%2Fdocker.sock/v1.51/images/YOUR-PACKAGE-NAME/json": dial unix /var/run/docker.sock: connect: permission denied

,