Windows
Run Dockerman on Windows with either Docker Desktop or the built-in WSL2 Docker Engine.
Windows has two supported Docker paths: Docker Desktop or the built-in WSL2 Docker Engine.
Quick comparison
| Aspect | Docker Desktop | WSL2 Docker Engine |
|---|---|---|
| Subscription | Required for most businesses | Not required |
| Footprint | Larger install | Small Alpine-based WSL distro |
| Resource usage | Higher, because it runs a VM and services | Lower, because it runs inside WSL2 |
| Setup effort | Standard installer | Automated by Dockerman |
| Support | Fully supported | Fully supported, added in v4.3.0 |
Option A: Docker Desktop
Install Docker Desktop
Download Docker Desktop from docker.com and run the installer.
Make sure Docker Desktop is running
Wait for the whale icon to show that Docker Desktop is running.
Launch Dockerman
Dockerman detects Docker Desktop automatically and connects to it.
Option B: WSL2 Docker Engine
Added in v4.3.0.
Dockerman bundles the WSL2 path for you, so you do not need Docker Desktop or manual WSL setup.
Prerequisites
- Windows 10 version 2004 or later, or Windows 11.
- WSL2 installed with
wsl --installfrom an elevated PowerShell session. - Virtualization enabled in BIOS or UEFI.
Setup Wizard
The Setup Wizard runs automatically on first launch when Docker Desktop is not detected.
Choose WSL2 Docker Engine
Pick the built-in WSL2 Docker Engine path when the welcome dialog appears.
Import Alpine
Dockerman imports a minimal Alpine WSL distro for the Docker Engine.
Install Docker inside Alpine
Dockerman installs Docker and configures the daemon to start on login.
Verify the connection
Dockerman runs a health check and connects to the new daemon.
Do not close Dockerman while the wizard is running. The first setup takes a few minutes and needs to finish before the app is usable.
What the wizard does
The wizard creates the Alpine distro files that Dockerman uses to run Docker.
Edit daemon.json
Use Settings → Daemon config panel to edit /etc/docker/daemon.json in either a form view for common fields or a raw JSON view for everything else. Saving restarts Docker inside the Alpine distro.
Recovery from daemon crash
If the Docker daemon crashes, Dockerman shows a banner with a Restart button and streams the crash logs so you can diagnose the failure.
Switch between Docker Desktop and WSL2 Engine
Open Settings → Docker settings
Open the Docker settings page from the app settings.
Pick the other backend
Switch between Docker Desktop and the WSL2 Docker Engine.
Reconnect
Save the change and reconnect to the selected backend.
Resource monitoring for WSL2
Use Stats to monitor the WSL2 Engine like any other Docker daemon. If Windows looks memory-heavy, check the WSL2 VM's ballooning in Task Manager.