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

Request: Ability to name preferred WSL environment

Open
#6,224 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

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

Research direction

Start by tracing how the Docker CLI selects its WSL distribution and read the linked WSL documentation for running a specific distribution. Define whether the change should select docker-desktop only or support a user-configured name, then verify that the chosen environment is used without relying on the default WSL distribution.

Written by the indexing model from the issue text.

Description

kind/feature status/0-triage
Description

Currently, Docker Desktop blindly applies the default WSL environment. However, VPN's and other components are often incompatible with Docker's need for WSL v2. So the user ends up with multiple environments.

You already select a predictable name for this distribution, docker-desktop. Please select this named distro, instead of following the default environment.

https://learn.microsoft.com/en-us/windows/wsl/basic-commands#run-a-specific-linux-distribution-from-powershell-or-cmd

Better yet, allow the user to name a custom environment, in case they want to replace docker-desktop with yet another WSL distribution.

Dominant language
Go
Stars
6.1k
Forks
2.2k
Avg merge
1d 10h
Merged PRs (30d)
47

Contributor guide

Open the contributing guide

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/cli

All issues in docker/cli

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.