Ubuntu 24.04 LTSにDockerをインストールする手順(公式apt・Compose対応)

公開日:

この記事では、開発環境やサーバー構築に欠かせないコンテナ技術、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など)を使用している場合は、以下の記事を参照してください。

AlmaLinux 9【LTS】Dockerインストール手順|RHEL 9互換
AlmaLinux 9【LTS】Dockerインストール手順|RHEL 9互換
安定版のAlmaLinux 9環境にDocker Engineをインストールする手順。長期サポート(LTS)環境でのコンテナ運用を目指すエンジニア向けガイド。
example.com
AlmaLinux 10【最新】Dockerインストール手順|RHEL 10互換
AlmaLinux 10【最新】Dockerインストール手順|RHEL 10互換
最新OS AlmaLinux 10環境にDocker Engineをインストールする手順。Podmanとの競合回避や、最新カーネル環境でのコンテナ構築について解説します。
example.com

検証環境

OSアーキテクチャDockerバージョンComposeバージョン
Ubuntu 24.04 LTSaarch64(ARM64)29.1v2.27

前提条件

  • OS: Ubuntu 24.04 LTS
  • 権限: sudo 権限を持つユーザーであること
  • ネットワーク: インターネット接続(パッケージダウンロード用)

インストール手順

Docker公式の手順に従い、GPGキーの登録からインストールまでを行います。

  1. 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’ はインストールされていません」と表示されても問題ありません。

  2. STEP

    GPGキーとリポジトリの準備

    公式リポジトリを安全に利用するための準備を行います。

    まず、必要なツールをインストールします。

    Terminal window
    sudo apt-get update
    sudo apt-get install -y ca-certificates curl gnupg

    次に、Docker公式のGPGキー(署名鍵)をダウンロードし、システムに保存します。

    Terminal window
    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
  3. 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
  4. 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
  5. STEP

    起動確認

    インストールが完了したら、サービスが起動しているか確認します。

    Terminal window
    sudo systemctl status docker --no-pager

    Active: active (running) と表示されていれば正常に動作しています。 もし起動していない場合は sudo systemctl enable --now docker を実行してください。

初期設定:一般ユーザーでの実行権限付与

インストール直後の状態では、Dockerコマンドの実行には毎回 sudo が必要です。 開発効率を上げるため、現在のユーザーを docker グループに追加して sudo なしで実行できるようにします。

info-icon warning

docker グループへの追加は、実質的にそのユーザーに rootと同等の権限 を与えることを意味します。信頼できるユーザーのみ設定してください。

  1. STEP

    ユーザーをグループに追加

    Terminal window
    sudo usermod -aG docker $USER
  2. STEP

    設定の反映

    設定を反映させるには「一度ログアウトして再ログイン」するか、以下のコマンドを実行します。

    Terminal window
    newgrp docker
  3. 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. 一般ユーザーでの実行権限設定が反映されていません。

  1. sudo usermod -aG docker $USER を実行したか確認してください。
  2. その後、必ず 再ログイン するか newgrp docker を実行してください。

Q. apt updateでエラーが出る

A. GPGキーの登録に失敗している可能性があります。 /etc/apt/sources.list.d/docker.list を削除し、GPGキーのダウンロード手順(chmod を含む)からやり直してください。

まとめ

Ubuntu 24.04 LTSにDocker公式リポジトリを追加し、最新のDocker環境を構築しました。 これで docker compose を使ったモダンな開発環境が整いました。

関連記事

Ubuntu 24.04 LTSにVSCodeをインストールする方法|公式リポジトリ・Snap
Ubuntu 24.04 LTSにVSCodeをインストールする方法|公式リポジトリ・Snap
Ubuntu 24.04 LTS (ARM64対応) にVisual Studio Codeをインストールする完全ガイド。推奨されるaptリポジトリ経由の手順と、Snap版の現状について解説。
example.com
Ubuntu 24.04 LTSでSSHサーバー構築&鍵認証を設定する方法
Ubuntu 24.04 LTSでSSHサーバー構築&鍵認証を設定する方法
Ubuntu 24.04 LTSにOpenSSHをインストールし、外部からパスワードなしでSSH接続(鍵認証)する手順を解説。物理サーバー・仮想マシン(UTM)の両環境で検証済み。
example.com