Docker Composeの設定ファイルの場所を確認する方法

はじめに

本記事では、Docker Composeで現在使用されている compose.yaml / docker-compose.yml の場所を確認する方法を紹介する。Docker Composeの設定ファイルの場所がわからなくなった場合に重宝する。

動作確認環境

• Ubuntu 22.04 x86_64
• Docker

  Client: Docker Engine - Community
   Version:           28.2.2
   API version:       1.50
   Go version:        go1.24.3
   Git commit:        e6534b4
   Built:             Fri May 30 12:07:28 2025
   OS/Arch:           linux/amd64
   Context:           default
  
  Server: Docker Engine - Community
   Engine:
    Version:          28.2.2
    API version:      1.50 (minimum version 1.24)
    Go version:       go1.24.3
    Git commit:       45873be
    Built:            Fri May 30 12:07:28 2025
    OS/Arch:          linux/amd64
    Experimental:     false
   containerd:
    Version:          1.7.27
    GitCommit:        05044ec0a9a75232cad458027ca83437aae3f4da
   runc:
    Version:          1.2.5
    GitCommit:        v1.2.5-0-g59923ef
   docker-init:
    Version:          0.19.0
    GitCommit:        de40ad0
  

  • Docker Compose v2

    Docker Compose version v2.36.2 
    

方法

【方法1】docker compose ls を使う方法

以下のコマンドで、起動中のDocker Composeの設定ファイルの場所を確認する。

docker compose ls

以下のように表示される。

NAME                                           STATUS              CONFIG FILES
compose-project-name                           running(N)          /path/to/config/files

• compose-project-name: Docker Compose のプロジェクト名

停止済みの Compose プロジェクトも含めて表示する場合は -a を付与する。

docker compose ls -a

【方法2】docker inspectを使う方法

jq コマンドが必要。未インストールの場合は以下で導入しておく。

sudo apt update
sudo apt install jq

以下のコマンドで、コンテナ情報を取得して、Docker Composeの設定ファイルの場所を確認する。

docker inspect <container-name> | jq '.[0].Config.Labels'

以下の "com.docker.compose.project.config_files" に、Docker Compose の設定ファイルのパスが表示される。

{
  "com.docker.compose.config-hash": 
"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "com.docker.compose.container-number": "1",
  "com.docker.compose.depends_on": "",
  "com.docker.compose.image": "sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "com.docker.compose.oneoff": "False",
  "com.docker.compose.project": "project-name",
  "com.docker.compose.project.config_files": "/path/to/config/files",
  "com.docker.compose.project.working_dir": "/path/to/working/dir",
  "com.docker.compose.service": "service-name",
  "com.docker.compose.version": "2.36.2",
  "org.opencontainers.image.ref.name": "ubuntu",
  "org.opencontainers.image.version": "24.04"
}

設定ファイルの場所のみ調べる場合は以下のコマンドを入力する。

docker inspect <container-name> | jq -r '.[0].Config.Labels["com.docker.compose.project.config_files"]'

まとめ

Docker Compose の設定ファイルの場所を確認する方法を紹介した。

実行中の Compose プロジェクト全体を確認する場合は docker compose ls、
コンテナ単位で確認する場合は docker inspect が便利である。

設定ファイルの場所がわからなくなった際に活用してほしい。

参考