Docker Cannot connect to the Docker daemon の原因と解決方法【デーモン起動と権限を徹底解説】

Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running? とは

Dockerを使い始めたばかりの頃や、久しぶりにDockerコマンドを実行しようとした時に遭遇しやすいのが「Cannot connect to the Docker daemon」エラーです。これは、DockerクライアントがDockerのバックエンドサービス（デーモン）と通信できない場合に発生します。多くのケースで慌ててしまいますが、原因はいくつかパターン化されており、落ち着いて対処すれば必ず解決できます。

エラーの発生パターン

このエラーは主に以下のようなケースで発生します。

パターン1: 1. Dockerデーモンが停止している、または起動していない

```bash
docker run hello-world
```
# 出力例:
# Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?

このエラーの最も一般的な原因は、Dockerデーモンが起動していないことです。Docker Desktopユーザーはアプリケーションが実行されているか、Linuxユーザーは`systemctl`などでサービスの状態を確認する必要があります。

```bash
# Linuxの場合: Dockerデーモンを起動する
sudo systemctl start docker

# macOS/Windows (Docker Desktop) の場合:
# Docker Desktopアプリケーションを起動し、完全に初期化されるまで待つ

# 起動後に再度コマンドを実行
docker run hello-world
```

パターン2: 2. Dockerソケットへのアクセス権限がない

```bash
docker ps
```
# 出力例:
# Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?
# (デーモンが起動していても、このエラーが出ることがあります)

Linux環境では、Dockerデーモンは`unix:///var/run/docker.sock`というUNIXソケットを介して通信します。このソケットへのアクセス権限が、現在のユーザーにない場合、デーモンが起動していてもエラーが発生します。通常、`docker`グループにユーザーを追加することで解決できます。

```bash
# 現在のユーザーをdockerグループに追加する
sudo usermod -aG docker $USER

# グループの変更を反映させるために再ログインまたは以下のコマンドを実行
# (セッションを再起動するのが確実です)
newgrp docker

# 再度コマンドを実行
docker ps
```
# 注意: `newgrp docker`は現在のシェルセッションに一時的にグループを適用しますが、
# 完全に反映させるにはログアウト/ログインが必要です。セキュリティ上の理由から、
# 常に`sudo`を使用する選択肢もありますが、開発効率のためにグループ追加が一般的です。

パターン3: 3. DOCKER_HOST環境変数の誤設定またはTLS設定の問題

```bash
# 環境変数DOCKER_HOSTが間違って設定されている場合
export DOCKER_HOST="tcp://192.168.1.100:2375" # 存在しないホストやポート
docker ps
```
# 出力例:
# error during connect: Get "http://192.168.1.100:2375/v1.24/containers/json": dial tcp 192.168.1.100:2375: connect: connection refused

DockerクライアントはデフォルトでローカルのUNIXソケット（Linux/macOS）または名前付きパイプ（Windows）を使用しますが、`DOCKER_HOST`環境変数を設定することで、リモートのDockerデーモンに接続するようになります。この変数が誤った値に設定されている、またはTLS証明書関連の設定（`DOCKER_TLS_VERIFY`, `DOCKER_CERT_PATH`）が不適切だと接続エラーが発生します。

```bash
# DOCKER_HOST環境変数を解除する (デフォルト設定に戻す)
unset DOCKER_HOST

# または、正しいホストとポートに設定する (リモート接続の場合)
# 例: WSL2環境でWindows側のDocker Desktopに接続する場合
# export DOCKER_HOST="tcp://localhost:2375"

# TLS関連の環境変数も確認・解除する
unset DOCKER_TLS_VERIFY
unset DOCKER_CERT_PATH

# 再度コマンドを実行
docker ps
```

根本原因の特定方法

このエラーが発生した場合の最も基本的なデバッグ方法は、まずDockerデーモンが実行中であるかを確認することです。次に、`docker info`コマンドを`sudo`付きで実行してみて、エラーが解消されるかを確認することで、権限の問題を切り分けられます。

```bash
# 1. Dockerデーモンの状態を確認 (Linuxの例)
sudo systemctl status docker

# 2. 権限を一時的に昇格してdockerコマンドを試す
sudo docker ps

# 3. DOCKER_HOST環境変数の確認
echo $DOCKER_HOST
```

防止策とベストプラクティス

このエラーを未然に防ぐには、Dockerの利用を開始する前に、{marker}ユーザーが`docker`グループに属しているかを確認し、必要であれば追加しておくこと{/marker}が重要です。また、Docker Desktopを使用している場合は、システム起動時に自動起動するように設定し、常に最新の状態に保つことで、予期せぬ接続問題を防ぐことができます。

```bash
# ユーザーをdockerグループに追加 (Linux)
sudo usermod -aG docker $USER

# .bashrc や .zshrc にてDOCKER_HOST環境変数を適切に管理する
# 例: WSL2環境でWindowsのDocker Desktopを使う場合のみ設定
# if grep -qEi "Microsoft|WSL" /proc/version &>/dev/null; then
#   export DOCKER_HOST="tcp://localhost:2375"
# fi
```

よくある質問（FAQ）

この用語と一緒に知っておきたい用語

このエラーと一緒にしっておきたいエラー