How to Fix Docker Permission Denied Error on Ubuntu
This detailed troubleshooting article helps you fix the permission denied error with Docker on Ubuntu and other Ubuntu-based Linux distributions.
Recently, I installed Docker on Ubuntu. It was super easy. But when I tried to run a docker command, it threw this error at me:
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.39/containers/json: dial unix /var/run/docker.sock: connect: permission denied
It’s not that I am trying to run something special. It happens for basic docker commands like ps as well.
Strange, isn’t it? Let me show you how to get past this annoying error.
Fixing ‘Got permission denied while trying to connect to the Docker daemon socket’ error with Docker in Ubuntu
There are two ways to deal with it:
- Run every docker command with sudo (annoying)
- Create a
dockergroup and add your user to this group (recommended)
Fix 1: Run all the docker commands with sudo
sudo docker ps -a CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 13dc0f4226dc ubuntu "bash" 17 hours ago Exited (0) 16 hours ago container-2 2d9a8c190e6c ubuntu "/bin/bash" 17 hours ago Created container-1
But running each and every docker command with sudo is super inconvenient. You miss adding sudo to the beginning and you’ll get the ‘permission denied’ error again.
Fix 2: Running docker commands without sudo (recommended)
To run the docker commands without sudo, you can add your user account (or the account you are trying to fix this problem for) to the docker group.
First, create the docker group using groupadd command. The group may already exist but running the group creation command won’t hurt.
sudo groupadd docker
Now that you have the docker group, add your user to this group with the usermod command. I am assuming that you are trying to do it for your own user account and in that case, you can use the $USER variable.
sudo usermod -aG docker $USER
Verify that your user has been added to docker group by listing the users of the group. You probably have to log out and log in back again.
abhishek@itsfoss:~$ groups abhishek adm cdrom sudo dip plugdev lpadmin sambashare docker
If you check your groups and docker groups is not listed even after logging out, you may have to restart Ubuntu. To avoid that, you can use the newgrp command liks this:
Now if you try running the docker commands without sudo, it should work just fine.
In some cases, you may need to add additional permissions to some files specially if you have run the docker commands with sudo in the past.
You may try changing the group ownership of the /var/run/docker.sock file.
sudo chown root:docker /var/run/docker.sock
You may also try changing the group ownership of the ~/.docker directory.
sudo chown "$USER":"$USER" /home/"$USER"/.docker -R sudo chmod g+rwx "$HOME/.docker" -R
And then try running docker with sudo. It should be fine.
I hope this little tutorial helped you to fix the annoying “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.39/containers/json: dial unix /var/run/docker.sock: connect: permission denied” error with Docker in Ubuntu.
Did it fix the problem for you? If yes, I welcome a quick comment of thanks from you. If not, I’ll be happy to help you fix this problem further.