Skip to main content

Docker permissions under Proxmox

This guide explains how to resolve Docker permission problems on a Proxmox VPS.

Problem​

Docker may encounter permission problems on Proxmox LXC containers.

Solution​

Enable necessary features​

Contact support to enable on your container:

  • nesting=1
  • keyctl=1

Or if you have access to the Proxmox node:

# In /etc/pve/lxc/ID.conf
features: nesting=1,keyctl=1

Docker installation​

After enabling features:

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

Log out and log back in.

Verification​

docker run hello-world

Alternative: Docker rootless​

If problems persist:

dockerd-rootless-setuptool.sh install

Common errors​

ErrorSolution
permission deniedCheck docker group
cannot connect to daemonRestart docker service
overlay filesystemEnable nesting
info

Some Docker features may be limited on LXC containers.