Error AtlasError Documentation and Resolution
Back to searchMore Docker errors

Docker

Docker rootless mode could not set up UID or GID mapping

[rootlesskit:parent] error: failed to setup UID/GID map: failed to compute uid/gid map: No subuid ranges found for user

Rootless Docker could not configure UID and GID mappings because /etc/subuid and /etc/subgid do not contain the required ranges for the current user.

No subuid ranges found for userrootless

Observed message

[rootlesskit:parent] error: failed to setup UID/GID map: failed to compute uid/gid map: No subuid ranges found for user

Why it happens

  • The current user has no subuid range configured in /etc/subuid.
  • The current user has no subgid range configured in /etc/subgid.

How to fix it

  1. Add the required subuid and subgid ranges for the user in /etc/subuid and /etc/subgid.
  2. Retry the rootless Docker setup after the mappings are configured.

Official reference

Docker Docs: Rootless troubleshooting

Related errors

cannot expose privileged portDocker rootless mode could not publish a privileged portfailed to start the child: no space left on deviceDocker rootless mode failed because max_user_namespaces is too smallfailed to start the child: operation not permittedDocker rootless mode failed to start because unprivileged user namespaces are disabledread unix @->/run/systemd/private: connection reset by peerDocker rootless run failed because the user dbus daemon is not running

Explore more

DockerBrowse more Docker errorsrootlessBrowse more rootless errors
Docker rootless No subuid ranges found for user: fixes | Error Atlas