Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

request: XDG_RUNTIME_DIR for the default docker cli rootless binary

Open
#260 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Stale
Tech stack
docker

Research direction

Start by locating the Docker CLI's default connection selection for rootless use, including handling of DOCKER_HOST, --context, and XDG_RUNTIME_DIR. Compare the existing default with the rootless socket behavior described in the issue, then verify that explicit hosts and contexts remain unchanged and that the default resolves to the requested socket.

Written by the indexing model from the issue text.

Description

Hi,

Can the docker rootless cli defaults to connect to $XDG_RUNTIME_DIR/docker.sock
instead of /var/run/docker.sock if no DOCKER_HOST or --context, and relatives defined?

Client:
 Context:    default
 Debug Mode: false
 Plugins:
  buildx: Build with BuildKit (Docker Inc., v0.6.3)

Server:
ERROR: Cannot connect to Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?
errors pretty printing info

it make sense as this is for rootless..

similar to podman approach -
"path defaults to either /run/podman/podman.sock, or /run/user/<uid>/podman/podman.sock if running rootless."

Thanks.

Dominant language
Shell
Stars
3.2k
Forks
863
Avg merge
3h 15m
Merged PRs (30d)
2

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from docker/docker-install

All issues in docker/docker-install

Similar issues

More Shell/Bash issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.