Docker on Windows.
No WSL.
hyperbutler is a lightweight, Docker‑compatible engine. It boots a minimal Linux
VM through the Windows Host Compute Service, runs dockerd inside it, and lets the
stock docker CLI talk to it.
PS C:\Users\you> hyperbutler start
hyperbutler is running: the Docker API answered after 1.5 s (engine pid 7412).
PS C:\Users\you> docker run --rm hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
Status: Downloaded newer image for hello-world:latest
Hello from Docker!
This message shows that your installation appears to be working correctly.
PS C:\Users\you>
Benchmarks
Lighter where it counts.
hyperbutler against Docker Desktop 4.97 (WSL 2), on one laptop, each with its default settings. Shorter bars are better.
Idle memory, VM running
Docker Desktop varied over the first 6 minutes; the faded part of its bar is that range.
Disk, 5 min after deleting ~5 GB of images
Download
The faded part is the WSL download, needed if WSL is missing.
Bind mount: read 2000 small files from C:\
Measured on one laptop (Windows 11 Home, Core Ultra 7 155H, 32 GB), one engine at a time, same script. Docker Desktop’s Resource Saver stops its VM after about 7 idle minutes; its processes then use 404 MiB. One machine is not a general result. Method and raw data
Features
Works well by default.
No tuning, no extra subsystem to keep updated. Install it, start it, run containers.
-
No WSL
The VM runs directly on the Windows Host Compute Service, the same API WSL 2 uses. WSL is not required, can stay disabled, and its updates do not affect hyperbutler.
3 resident processes at idle
-
Works on Windows 11 Home
Home is first-class; Pro and Enterprise work too. You need an x64 PC with virtualization enabled in the firmware.
-
Disk space given back automatically
Delete images and the data disk shrinks on its own. No manual compaction, no admin step.
-
Fast bind mounts from C:\
Mount a Windows folder with
-v C:\src:/src. Reading 2000 small files took 0.4 s. -
Stock docker CLI + Compose
The
dockerCLI and the compose plugin are bundled and set up through ahyperbutlerdocker context. -
No telemetry
hyperbutler sends no usage data. The app only checks GitHub for updates once a day, and you can turn that off.
-
Open source, Apache-2.0
The source is on GitHub. Free to use at any company size.
Install
Three steps to hello-world.
You need Windows 11 (Home, Pro or Enterprise) on x64, with virtualization enabled in the firmware.
-
Run the MSI
Download it from the latest release. One UAC prompt, then it:
- adds hyperbutler and its
dockerCLI to the PATH; - adds you to Hyper-V Administrators, if you leave that box ticked;
- turns on Virtual Machine Platform if it is missing.
- adds hyperbutler and its
-
Sign out and back in
The group membership applies at your next sign-in. If Virtual Machine Platform was just turned on, Windows asks for a restart instead.
-
Run a container
> hyperbutler start > docker run hello-world
Unsigned preview
Builds are not code-signed yet, so SmartScreen says “Windows protected your
PC”: choose More info, then Run anyway.
Check the file against SHA256SUMS from the release first:
Get-FileHash .\hyperbutler-*-windows-amd64.msi -Algorithm SHA256
About Hyper-V Administrators
The group lets every program you run control the Hyper-V VMs on this PC, not just hyperbutler. Treat it as close to admin rights. Prefer no installer? The zip needs no admin rights for itself; see the install guide.
Preview
This is an early preview.
It works end to end on Windows 11 Home, but some things are still open. Among them:
- The 24-hour soak test has not been run (the 1-hour run passed).
- Until the HCS access broker ships, your account needs Hyper-V Administrators membership.
- Docker Compose has not been tested yet.
- Bind mounts from Windows paths work, but are not yet fast for write-heavy trees: use a named volume for
node_modules. - Builds are not code-signed, and the installer is English only.