Debian 13でDocker Compose環境を構築する手順まとめ【Compose v2対応】

Debian 13（Trixie）で Docker Compose を使ったコンテナ環境を構築したい場合、 従来の docker-compose コマンドではなく、 Docker Compose v2（docker compose） を使うのが正解です。

本記事では、Debian 13 において Docker Engine と Docker Compose を正しく導入し、 実際にコンテナを起動するまでの具体的な作業手順を、 つまずきやすいポイントを押さえながら解説します。

---

前提環境

• OS：Debian 13（Trixie）
• ユーザー：sudo 権限を持つ一般ユーザー
• ネットワーク：インターネット接続可能

root ログイン前提ではなく、一般ユーザーでの運用を想定しています。

---

手順① 必要なパッケージをインストールする

まず、Docker の公式リポジトリを追加するために必要なパッケージを導入します。

sudo apt update
sudo apt install -y \
  ca-certificates \
  curl \
  gnupg \
  lsb-release

---

手順② Docker公式GPGキーを登録する

Docker公式リポジトリを安全に利用するため、GPGキーを登録します。

sudo install -m 0755 -d /etc/apt/keyrings

curl -fsSL https://download.docker.com/linux/debian/gpg \
 | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

sudo chmod a+r /etc/apt/keyrings/docker.gpg

---

手順③ Docker公式リポジトリを追加する

Debian 13（Trixie）対応の Docker リポジトリを追加します。

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/debian \
  $(lsb_release -cs) stable" \
 | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

念のため、ディストリビューション名を確認します。

lsb_release -cs

trixie と表示されていれば問題ありません。

---

手順④ Docker Engine と Compose Plugin をインストール

Docker本体と、Docker Compose v2（plugin）をまとめてインストールします。

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

docker-compose-plugin が Docker Compose v2 に該当します。

---

手順⑤ Dockerサービスを起動・自動起動設定する

sudo systemctl enable docker
sudo systemctl start docker

状態確認：

systemctl status docker

active (running) になっていれば正常です。

---

手順⑥ 一般ユーザーでDockerを使えるようにする

毎回 sudo を付けずに Docker を使うため、ユーザーを docker グループに追加します。

sudo usermod -aG docker $USER

必ずログアウトして再ログインしてください。 SSH 接続の場合は一度切断して再接続します。

確認：

docker ps

エラーが出なければ設定完了です。

---

手順⑦ Docker Compose v2 の動作確認

Docker Compose が正しく使えるか確認します。

docker compose version

以下のように表示されれば成功です。

Docker Compose version v2.x.x

※ docker-compose コマンドは使いません。

---

手順⑧ Docker Composeでコンテナを起動してみる

テスト用ディレクトリを作成します。

mkdir compose-test
cd compose-test

docker-compose.yml を作成します。

nano docker-compose.yml

services:
  web:
    image: nginx:latest
    ports:
      - "8080:80"

コンテナを起動します。

docker compose up -d

状態確認：

docker compose ps

ブラウザで以下にアクセスします。

http://サーバーのIPアドレス:8080

Nginx の初期画面が表示されれば成功です。

---

コンテナの停止と削除

docker compose down

---

よくある注意点

• Debian 13 では docker compose が正解
• compose.yml に version 指定は不要
• 本番運用では restart: unless-stopped を設定する
• 長時間作業では tmux の併用を推奨

---

まとめ

Debian 13 で Docker Compose 環境を構築するには、 Docker公式リポジトリから Docker Engine と Compose Plugin を導入するのが最短ルートです。

本記事の手順通り進めれば、Docker Compose を使った 開発・検証・本番環境の構築までスムーズに行えるようになります。