Got permission denied while trying to connect to the Docker daemon socket

OS를 새로 설치하는 등의 작업으로 도커도 새로 설치하였을 때, "docker" 명령을 실행하면 다음과 같은 오류가 발생하는 경우가 있습니다.

$ docker version
Client: Docker Engine - Community
 Version:           20.10.7
 API version:       1.41
 Go version:        go1.13.15
 Git commit:        f0df350
 Built:             Wed Jun  2 11:56:38 2021
 OS/Arch:           linux/amd64
 Context:           default
 Experimental:      true
Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get http://%2Fvar%2Frun%2Fdocker.sock/v1.24/version: dial unix /var/run/docker.sock: connect: permission denied

이는 현재 사용자가 "/var/run/docker.sock" 파일에 대한 접근 권한이 없어서 발생하는 문제입니다.

현재 사용자가 "docker" 명령을 이용하기 위해서는 "root:docker" 권한을 가지고 있어야 합니다.

 

다음과 같이 현재 사용자를 "docker" 그룹에 추가하면 위의 문제를 간단하게 해결할 수 있습니다.

$ sudo usermod -a -G docker $USER

"id" 명령을 이용하여 추가된 그룹을 확인할 수 있습니다.

$ id
uid=1000(hunature) gid=1000(hunature) groups=1000(hunature),4(adm),24(cdrom),27(sudo),30(dip),46(plugdev),120(lpadmin),131(lxd),132(sambashare),998(docker)

또는 다음과 같이 "/etc/group" 파일을 직접 확인해 볼 수도 있습니다.

$ cat /etc/group | grep docker

docker:x:998:hunature

"docker" 그룹에 속한 이후에는 "docker" 명령을 자유롭게 이용할 수 있습니다.

:~$ docker version
Client: Docker Engine - Community
 Version:           20.10.7
 API version:       1.41
 Go version:        go1.13.15
 Git commit:        f0df350
 Built:             Wed Jun  2 11:56:38 2021
 OS/Arch:           linux/amd64
 Context:           default
 Experimental:      true

Server: Docker Engine - Community
 Engine:
  Version:          20.10.7
  API version:      1.41 (minimum version 1.12)
  Go version:       go1.13.15
  Git commit:       b0f5bc3
  Built:            Wed Jun  2 11:54:50 2021
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.4.8
  GitCommit:        7eba5930496d9bbe375fdf71603e610ad737d2b2
 runc:
  Version:          1.0.0
  GitCommit:        v1.0.0-0-g84113ee
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0