はじめに
Dockerをいざ使おうとした時に、Dockerのコマンド実行時に「ERROR: Couldn’t connect to Docker daemon at http+docker://localhost – is it running?」というエラーが表示されました。この記事ではこのエラーの原因と解決方法をまとめます。
エラーの内容
DockerとDocker Composeをインストールし、いざDockerとDocker Composeを使おうとコマンドを実行したところ、以下のようなエラーが表示されました。
$ docker-compose run web rails new . --force --database=mysql --skip-bundle
ERROR: Couldn't connect to Docker daemon at http+docker://localhost - is it running?
If it's at a non-standard location, specify the URL with the DOCKER_HOST environment variable.上記はRails環境を構築しようとした際に使ったDocker Compoesのコマンドですが、他のDockerコマンドやdocker-composeに続く内容に関わらず表示されるエラーです。
Couldn’t connect to Docker daemonの原因
これは、「Dockerデーモンに接続できなかった」という内容で、Dockerの使用権限がデフォルトではrootのみに与えられており、root権限を持たない通常ユーザでDockerのコマンドを実行したことが原因です。なぜデフォルトではrootにのみ使用権限が与えられているかというと、DockerではUnixソケットを使用しますが、このUnixソケットの使用権限がrootにしか付与されていません。
そのため、Docker、Docker Composeは実行時にroot権限が必要となります。
したがって、解決方法は以下の２つが考えられます。
sudoを使うdockerグループを作成して、そこに通常ユーザを加える
上記２つについてそれぞれ説明します。
sudoを使う
これは簡単で、具体的には以下のようにsudoを付けて実行すれば解決です。
$ sudo docker-compose run web rails new . --force --database=mysql --skip-bundle毎回sudoを使うのが面倒な場合は、２番目の解決策が参考になると思います。
dockerグループを作成して、そこに通常ユーザを加える
dockerという名前のグループを作成し、そこに通常ユーザを追加します。
dockerグループを確認、作成する
環境によってはすでにdockerグループが作成されている場合もありますので、以下のコマンドで一度グループ一覧を確認してみます。
$ cat /etc/group | grep docker
docker:x:999:私の環境では、DockerとDocker Compoesをインストールした時点で上記のようにすでにdockerグループが作成されていました。
もし、上記コマンド結果に何も出力されない場合は、以下でdockerグループを作成します。
$ sudo groupadd docker通常ユーザをdockerグループに追加する
続いて以下のコマンドで通常ユーザをdockerグループに追加します。
$ sudo usermod -aG docker $USER上記の$USERは、環境変数で現在ログイン中の通常ユーザのユーザ名です。
上記を実行後、以下で通常ユーザが属するグループを確認してみると、dockerグループが所属するグループとして含まれていることを確認できます。tarouというのが通常ユーザです。
$ groups $USER
tarou : tarou adm cdrom sudo dip plugdev lpadmin sambashare kvm libvirt dockerグループの追加を反映させるには、ログインし直す必要があるので、一度ログアウトして再ログインしてください。
後は以下のようにsudoなしでもDocker、Docker Composeを使用できるようになります。
$ docker-compose run web rails new . --force --database=mysql --skip-bundleWARNINGが出る場合
もし上記のdockerグループに追加する対策をする前に、sudoを実行してDockerコマンドを実行した場合は、ホームディレクトリ直下に.dockerというディレクトリが作成されています。このディレクトリが残った状態で上記のdockerグループに追加する対策をした後に、sudoなしでDockerのコマンドを実行すると以下のような警告が出る場合があります。
WARNING: Error loading config file: /home/tarou/.docker/config.json -
stat /home/tarou/.docker/config.json: permission deniedこれは、作成された.dockerディレクトリのパーミッションがroot権限になってしまっているために出る警告です。これを解決するには、一度.dockerディレクトリを削除します。.dockerは、削除してもDockerコマンド実行時に自動で再作成されます。
もしくは、以下のようにroot権限から通常ユーザに権限を付与してももちろん大丈夫です。
$ sudo chown "$USER":"$USER" /home/"$USER"/.docker -R
$ sudo chmod g+rwx "$HOME/.docker" -R参考文献
以下の公式ドキュメントにしっかりと書いてありました。
Post-installation steps for Linux
This section contains optional procedures for configuring Linux hosts to work better with Docker. Manage Docker as a non-root user The Docker daemon binds to a Unix socket instead of…
まとめ
Dockerを使い始めた時に遭遇しやすいエラーだと思います。同じようなエラーに遭遇している方の参考になれば幸いです。
SPONSORED LINK
