Skip to content

docs: warn that sudo docker login often writes root's config.json - #7161

Open
locker95 wants to merge 1 commit into
docker:masterfrom
locker95:docs/login-sudo-home-5384
Open

docs: warn that sudo docker login often writes root's config.json#7161
locker95 wants to merge 1 commit into
docker:masterfrom
locker95:docs/login-sudo-home-5384

Conversation

@locker95

@locker95 locker95 commented Aug 6, 2026

Copy link
Copy Markdown

The old root/sudo/docker-machine wording is long gone, but the HOME trap is still real: `sudo docker login` frequently stores creds under /root/.docker while your normal docker client reads ~/.docker.

Short note + sudo -E / DOCKER_CONFIG escape hatch.

Fixes #5384

$HOME under sudo is usually /root, so credentials miss the invoking
user's ~/.docker and later non-sudo commands look logged out.

Fixes docker#5384

Signed-off-by: Dean Chen <862469039@qq.com>
@locker95
locker95 requested review from a team and thaJeztah as code owners August 6, 2026 18:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docker login reference can use some TLC

1 participant