できない.dev

Docker build できない(Cannot connect to the Docker daemon)

Docker daemon が起動していない、または現ユーザーが docker グループに属していないと build/run の全てが失敗する。
OS別に確認手順が異なる。

公開: 更新:

症状できない · exit 1
docker build --progress=plain -t daemon-demo .
ERROR: failed to connect to the docker API at unix:///var/run/does-not-exist.sock; check if the path is correct and if the daemon is running: dial unix /var/run/does-not-exist.sock: connect: no such file or directory
解決後できた · exit 0
docker build --progress=plain -t daemon-demo .
…
#7 exporting layers 0.7s done
#7 writing image sha256:ccab1dda556402638cbdc98b9c59f0b7f461818649f2887347dd758c3b9087e3 done
#7 naming to docker.io/library/daemon-demo done
#7 DONE 0.7s

2026-08-06 に github-actions-runner (host docker) で実際に打って取った出力。検証環境の詳細

要約

docker build 実行時に Cannot connect to the Docker daemon at unix:///var/run/docker.sock や error during connect が出る場合は、daemon が起動していないか、権限が足りていない。
確認すべき手順は OS 別に異なる。

実行例

GitHub Actions Runner(Ubuntu 24.04 / Docker 28.0.4)で上記の手順を動かした。
DOCKER_HOST に不正なソケットパス unix:///var/run/does-not-exist.sock が残った状態では、終了コード 1 でビルドが失敗した。
unset DOCKER_HOST を実行した直後の再ビルドは、終了コード 0 で正常に完了した。

$ docker build --progress=plain -t daemon-demo .
ERROR: failed to connect to the docker API at unix:///var/run/does-not-exist.sock; check if the path is correct and if the daemon is running: dial unix /var/run/does-not-exist.sock: connect: no such file or directory
$ echo $?
1
$ echo $DOCKER_HOST
unix:///var/run/does-not-exist.sock
$ unset DOCKER_HOST
$ docker build --progress=plain -t daemon-demo .
#0 building with "default" instance using docker driver
 
#1 [internal] load build definition from Dockerfile
#1 transferring dockerfile: 63B 0.0s done
#1 DONE 0.0s
 
#2 [auth] library/alpine:pull token for registry-1.docker.io
#2 DONE 0.0s
 
#3 [internal] load metadata for docker.io/library/alpine:3
#3 DONE 0.3s
 
#4 [internal] load .dockerignore
#4 transferring context: 2B done
#4 DONE 0.0s
 
#5 [1/2] FROM docker.io/library/alpine:3@sha256:28bd5fe8b56d1bd048e5babf5b10710ebe0bae67db86916198a6eec434943f8b
#5 resolve docker.io/library/alpine:3@sha256:28bd5fe8b56d1bd048e5babf5b10710ebe0bae67db86916198a6eec434943f8b done
#5 sha256:28bd5fe8b56d1bd048e5babf5b10710ebe0bae67db86916198a6eec434943f8b 9.22kB / 9.22kB done
#5 sha256:79ff19e9084a00eece421b2523fb93e22d730e2c0e525905de047e848e56d95f 1.02kB / 1.02kB done
#5 sha256:d529dd0c6e5597ac7e4a3e2dea65c3fcc6173f4cae713c409265c1dd9914a11b 611B / 611B done
#5 DONE 0.0s
 
#6 [2/2] RUN echo ok
#6 0.159 ok
#6 DONE 0.4s
 
#7 exporting to image
#7 exporting layers
#7 exporting layers 0.7s done
#7 writing image sha256:ccab1dda556402638cbdc98b9c59f0b7f461818649f2887347dd758c3b9087e3 done
#7 naming to docker.io/library/daemon-demo done
#7 DONE 0.7s
$ echo $?
0

— 2026-08-06 時点の出力

検証環境2026-08-06 検証
検証日
実行環境
github-actions-runner (host docker)

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. daemon 起動確認

# Linux
sudo systemctl status docker
sudo systemctl start docker
 
# macOS / Windows
# Docker Desktop アプリを起動。タスクトレイのクジラアイコンが安定するまで待つ

2. docker グループへ追加(Linux)

sudo usermod -aG docker $USER
# いったんログアウト → 再ログイン(newgrp docker でも可)
docker run --rm hello-world

3. DOCKER_HOST を確認

echo $DOCKER_HOST   # 空のはず。値が入っていれば unset
unset DOCKER_HOST

4. WSL 連携(Windows)

Docker Desktop → Settings → Resources → WSL Integration で、対象ディストロを ON にする。

よくある原因

  1. daemon が起動していない。
    Docker Desktop が落ちているか、Linux で dockerd が止まっている。
  2. 権限が足りない(Linux)。
    docker.sock への RW 権限が無い(docker グループに所属していない)。
  3. DOCKER_HOST が不正な値になっている。
    リモート Docker 用の環境変数が残っている。
  4. WSL 連携が OFF になっている(Windows)。
    WSL ディストロから Docker が見えない。