docker permission denied 해결

서버에 Docker를 설치하고 Docker 명령어 확인을 위해 docker ps나 docker images 등을 실행하면 아래와 같이 docker permission denied 에러가 뜬다. 이에 대한 원인과 해결하기 위한 방법을 알아본다.

 

원인

docker 명령어를 사용하는 docker 데몬은 Unix 소켓을 통해서 실행이 된다. 에러 내용에서 확인할 수 있듯이 /var/run/docker.sock 파일은 root 사용자 권한으로 설정이 되어 있다. 따라서 이를 일반 사용자가 접근 할 수 있도록 하기 위해서는 docker 그룹을 만들고 여기에 일반 사용자를 추가해서 해결한다.

 

해결

docker 그룹에 사용자를 추가한다.

# docker 그룹에 사용자 추가 
sudo usermod -aG docker $USER

 

일반적으로 docker를 설치하면 docker 그룹은 생성이 되는데, 만약 없는 경우는 아래 명령으로 docker 그룹을 추가한다.

# docker 그룹 추가 
sudo groupadd docker

 

다음으로 해당 사용자로 다시 서버에 접속하거나 or 아래 명령어를 입력한다.

newgrp docker

 

다음 명령으로 사용자가 속한 그룹을 확인 해봐도 된다.

groups

 

에러가 없어졌는지 docker 명령어를 실행해본다.

 

혹시, 안될 경우 아래와 같이 /var/run/docker.sock 파일에 직접 권한을 부여하는 방법도 있는데 권장하지는 않는 방법이다.

sudo chmod 666 /var/run/docker.sock