この記事では、開発環境やサーバー構築に欠かせないコンテナ技術、Docker Engineを Ubuntu 24.04 LTS にインストールし、Docker Composeを使えるようにするまでの手順を解説します。
Ubuntu 24.04 LTS Docker構築ガイド
はじめに
Ubuntuの標準リポジトリ(apt install docker.io)でもDockerはインストールできますが、バージョンが古かったり、更新が遅れたりすることがあります。
本記事では、Docker公式リポジトリを追加し、常に最新の安定版(Stable)を利用できる構成を紹介します。
この手順は公式ドキュメントに基づき、Ubuntu 24.04実機で動作確認を行っています。
この記事でできること
- 公式リポジトリから最新のDocker Engineを導入できる
docker composeコマンド(v2)を使えるようにするsudoなしでDockerコマンドを実行できるようにする- よくあるエラー(Permission denied等)の対処法がわかる
他のLinuxディストリビューションの場合
RHEL系(AlmaLinuxなど)を使用している場合は、以下の記事を参照してください。
検証環境
| OS | アーキテクチャ | Dockerバージョン | Composeバージョン |
|---|---|---|---|
| Ubuntu 24.04 LTS | aarch64(ARM64) | 29.1 | v2.27 |
前提条件
- OS: Ubuntu 24.04 LTS
- 権限:
sudo権限を持つユーザーであること - ネットワーク: インターネット接続(パッケージダウンロード用)
インストール手順
Docker公式の手順に従い、GPGキーの登録からインストールまでを行います。
- STEP
既存の競合パッケージを削除
Ubuntuにプリインストールされているパッケージや、古いバージョンのDockerが残っていると競合を起こす可能性があります。まずはこれらを削除(アンインストール)します。
Terminal window for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done※「パッケージ ‘xxx’ はインストールされていません」と表示されても問題ありません。
- STEP
GPGキーとリポジトリの準備
公式リポジトリを安全に利用するための準備を行います。
まず、必要なツールをインストールします。
Terminal window sudo apt-get updatesudo apt-get install -y ca-certificates curl gnupg次に、Docker公式のGPGキー(署名鍵)をダウンロードし、システムに保存します。
Terminal window sudo install -m 0755 -d /etc/apt/keyringscurl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpgsudo chmod a+r /etc/apt/keyrings/docker.gpg - STEP
aptリポジトリの追加
以下のコマンドを実行して、Ubuntu 24.04 (noble) 用のリストを作成します。このコマンドはCPUアーキテクチャ(amd64/arm64)を自動判別します。
Terminal window 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追加したら、パッケージリストを更新します。
Terminal window sudo apt-get update - STEP
Docker Engineのインストール
準備が整ったので、Docker本体とCLIツール、Composeプラグインを一括でインストールします。
Terminal window sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin - STEP
起動確認
インストールが完了したら、サービスが起動しているか確認します。
Terminal window sudo systemctl status docker --no-pagerActive: active (running)と表示されていれば正常に動作しています。 もし起動していない場合はsudo systemctl enable --now dockerを実行してください。
初期設定:一般ユーザーでの実行権限付与
インストール直後の状態では、Dockerコマンドの実行には毎回 sudo が必要です。
開発効率を上げるため、現在のユーザーを docker グループに追加して sudo なしで実行できるようにします。
docker グループへの追加は、実質的にそのユーザーに rootと同等の権限 を与えることを意味します。信頼できるユーザーのみ設定してください。
- STEP
ユーザーをグループに追加
Terminal window sudo usermod -aG docker $USER - STEP
設定の反映
設定を反映させるには「一度ログアウトして再ログイン」するか、以下のコマンドを実行します。
Terminal window newgrp docker - STEP
動作確認
sudoなしでhello-worldコンテナを実行してみましょう。Terminal window docker run --rm hello-world以下のようなメッセージが表示されれば、インストールと権限設定は成功です!
Hello from Docker!This message shows that your installation appears to be working correctly....
よくあるエラーと対処法(Troubleshooting)
Q. permission denied … connect to the Docker daemon socket
A. 一般ユーザーでの実行権限設定が反映されていません。
sudo usermod -aG docker $USERを実行したか確認してください。- その後、必ず 再ログイン するか
newgrp dockerを実行してください。
Q. apt updateでエラーが出る
A. GPGキーの登録に失敗している可能性があります。
/etc/apt/sources.list.d/docker.list を削除し、GPGキーのダウンロード手順(chmod を含む)からやり直してください。
まとめ
Ubuntu 24.04 LTSにDocker公式リポジトリを追加し、最新のDocker環境を構築しました。
これで docker compose を使ったモダンな開発環境が整いました。
関連記事