wsl2-docker-quickstart: a Portuguese guide for running Docker on WSL 2
Guia/Tutorial rápido do WSL2 + Docker
At a glance
- What is it?
- codeedu/wsl2-docker-quickstart is a README-only tutorial covering WSL 2 installation, WSLg, and the two ways to run Docker on Windows. It is a decision document as much as a setup guide, and its usefulness depends on you reading the trade-off lists rather than copying commands.
- Who is it for?
- Adopt it if you are setting up a Windows development machine for the first time and want the Docker Desktop versus Docker Engine trade-offs laid out before you commit. If you need English-language setup steps, use README.en.md, the English version the README links to.
- Can I use it commercially?
- Not without permission. GitHub finds no licence file in the repository, and without a licence all rights are reserved by default: you may read the code but not reuse it. Check the README, or ask the authors, before using it.
- Is it still maintained?
- Activity is slowing. The repository last received commits 7 months ago.
- What is it written in?
- GitHub does not report a main language for this repository.
Answers come from the project's GitHub data, last synced on November 14, 2026, and from our analysis. They are not legal advice.
Star history
- codeedu/wsl2-docker-quickstart4,487 ★ · +3
| Repository | 2026-09-23 | 2026-11-14 |
|---|---|---|
| codeedu/wsl2-docker-quickstart | 4.5k | 4.5k |
3 Stars in the last 52 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
A tutorial repository with no code, only a README
The repository has four top-level entries: .gitignore, README.en.md, README.md, and an img directory. There is no installer, no CLI, no package, and no configuration file shipped to the user. The product is the document. That matters for how you evaluate it. You cannot pin a version, you cannot read a changelog of behaviour changes, and the repository has no published releases. What you get is a maintained set of instructions, and the last push was on 2026-03-28.
The audience is narrow and clear: developers on Windows 10 or 11 who want a Linux kernel for Docker and do not already know which of Microsoft's several setup paths to take. The README is written in Portuguese, with README.en.md as the English translation, so the English reader is reading a mirror of the primary document rather than the primary itself.
What the guide actually decides for you
Most WSL 2 write-ups stop at installation. This one spends its Docker section on a comparison of four ways to run Docker on Windows, two of which it labels obsolete: Docker Toolbox, and Docker Desktop with Hyper-V. The two live options are Docker Desktop with the WSL 2 backend, and Docker Engine installed natively inside the WSL 2 distribution.
The guide gives each live option its own vantagens and desvantagens list, then a separate section titled "Qual modo de usar Docker no Windows escolher?" That is the part worth reading before you type anything. The document treats the choice as the central question rather than a footnote. A reader who skips to the install commands and picks the first one will still get a working setup, but will have skipped the only section that explains why the other one exists.
Installing WSL 2 and Docker Engine without Docker Desktop
The README covers installation in stages: Windows Update, then updating WSL, then optionally enabling WSL on older Windows 10 builds, then setting version 2 as the default, then installing Ubuntu. The guide also documents an alternative install through the Microsoft Store.
For the native Docker route, the guide has a dedicated section for Docker Engine installed directly in WSL 2, plus a subsection on a startup error on Ubuntu 22.04, one on starting Docker automatically in WSL, and one on running Docker with systemd. The automatic-start subsection is the one to read if you do not want to run the daemon by hand after every reboot. The systemd subsection matters because Docker's own service management assumes an init system that WSL 2 did not always provide, and the guide's separate treatment of it is a signal that the two interact.
The .wslconfig and wsl.conf sections are the real operational content
Two configuration files get their own entry in the tips section: .wslconfig and wsl.conf. These are not the same file and do not live in the same place, and conflating them is a common source of confusion. The guide also documents applying autoMemoryReclaim in WSL 2 and a separate section on freeing RAM from WSL 2, which tells you the author considers memory reclamation a recurring problem rather than a one-time setting.
Alongside those, the tips section covers compacting the WSL 2 virtual disk and expanding it. Both operations touch the same VHDX file from opposite directions, and a reader who only finds the compaction entry may not realise the disk can also be grown. Other entries cover LAN and VPN networking, accessing Windows disks and devices from Linux, accessing WSL 2 from Windows, running Windows executables inside WSL 2, listing installed distributions, stopping all of them, and backing up and restoring a distribution.
The backup and restore entry is the one with the least margin for error.
Where the guide stops being the right tool
It is a Windows-side document. If your team is on macOS or Linux, nothing here applies except the general Docker concepts, and you would be reading it for the Docker mode comparison alone. The Portuguese-first choice also means an English-speaking team gets a translation that may lag the primary file, which is a real cost when the instructions concern a moving target like WSL 2 updates.
The guide is also not a substitute for Microsoft's own documentation on WSL versions or on Docker Desktop licensing. The README links out to Microsoft's compare-versions page rather than restating it, which is the honest choice, but it means the guide's coverage of WSL behaviour is a snapshot. There are no releases and no versioned artifacts to pin.
One more boundary: the guide covers WSLg and how to enable it, and it has a FAQ entry on running graphical applications in WSL 2. That is a different concern from Docker, and a reader who wants only containers can skip the entire WSLg section without losing anything.
Docker Desktop versus a plain Linux VM
The obvious alternative to this whole approach is running a Linux virtual machine with VirtualBox or VMware and installing Docker inside it. The difference in approach is architectural. WSL 2 runs a real Linux kernel in a lightweight utility VM that Microsoft manages and integrates with the Windows filesystem and terminal, while a traditional VM gives you a full guest operating system you configure yourself, with its own networking stack and its own resource allocation.
The guide addresses the coexistence question directly in its FAQ, asking whether WSL 2 works alongside other virtual machines such as VirtualBox or VMware. It also asks whether WSL can be used in production scenarios, and whether you need a Windows 10/11 Pro licence to use WSL 2. Those three questions are exactly the ones a team evaluating this route will ask, and their presence in the document is more useful than the installation steps for anyone making an adoption decision rather than following a tutorial.
Editorial conclusion
Adopt it if you are setting up a Windows development machine for the first time and want the Docker Desktop versus Docker Engine trade-offs laid out before you commit. If you need English-language setup steps, use README.en.md, the English version the README links to. Verify first which Windows build you have, because the guide also documents an optional route for enabling WSL on older Windows 10 versions.
Frequently asked questions
How do I start Docker in WSL2 with wsl2-docker-quickstart?
The guide has a dedicated section on starting Docker automatically in WSL, and a separate one on running Docker with systemd. Which applies depends on whether you installed Docker Desktop with the WSL 2 backend or Docker Engine natively inside the distribution.
Is WSL2 needed for Docker according to wsl2-docker-quickstart?
The guide frames WSL 2 as the way to run Docker on Windows 10/11, describing WSL 1 as unable to run Docker because it lacked a full Linux kernel. It also lists Docker Desktop with Hyper-V as an obsolete mode, which is the older non-WSL route.
How to install WSL2 for Docker with wsl2-docker-quickstart?
The guide walks through Windows Update, updating WSL, optionally enabling WSL on older Windows 10 versions, setting version 2 as the default, and installing Ubuntu. It also documents installing WSL 2 through the Microsoft Store as an alternative path.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/codeedu-wsl2-docker-quickstart)Star history chart for your README
[](https://hysenlabs.com/projects/codeedu-wsl2-docker-quickstart)Was this useful?