このドキュメントでは、WSL2 環境に Docker をインストールする手順を説明します。 Docker Desktop のインストール手順については、触れません。
想定プラットフォームは Windows 11 + WSL2 + Ubuntu 24.04 です。
以下の環境を想定
- Ubuntu 24
- 既存パッケージリストの更新
sudo apt update
sudo apt upgrade -y- 競合パッケージのクリーン
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done- Docker リポジトリの追加
- 必要なツールのインストール
sudo apt install ca-certificates curl software-properties-common gnupg lsb-release -y- 公式 GPG キーの追加
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- リポジトリの設定
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null- Docker Engine のインストール
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y- 起動確認、sudo 無しで実行できるように
sudo docker run hello-world
# or
sudo docker --version- 確認メッセージ、またはバージョンが表示されれば成功です
sudo usermod -aG docker $USER- 実行後 Ubuntu ターミナル、または wsl を再起動し以下のコマンドを実行
docker run hello-world- 自動起動設定
sudo vi /etc/wsl.conf- 以下のように systemd が有効化されていることを確認
[boot]
systemd=true
- 自動起動設定を追加
sudo systemctl enable docker
sudo systemctl start docker- サービスの状態を確認
sudo systemctl status docker