WindowsinDocker

Windows in Docker runs a full Windows operating system inside a Docker container using KVM hardware acceleration for near-native performance.

  • Infrastructure
  • Network Services
  • Other
  • Tools & Utilities
Windows in Docker runs a full Windows operating system inside a Docker container using KVM hardware acceleration for near-native performance. It automatically downloads and installs Windows, supports modern and legacy releases, and allows customisable CPU, memory, and storage allocation for homelab users who need a Windows environment without a dedicated machine.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

77/100 Good

Maintained
98last commit 46 days ago
Popular
9553,992 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
404 GB minimum RAM, runs on ARM
Security check
85no serious findings, CI

Availability: platform listings confirmed today, links checked 53 days ago

GitHub stars
53,992
Open issues
20
Last commit
2026-10-05
Latest release
v6.06
License
MIT
Activity
stale

Checked 20 days ago - source: GitHub (dockur/windows)

Resources & Compatibility

Minimum requirements: 4 GB RAM, 2 CPU core(s). ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • System Requirements Requires /dev/kvm for KVM hardware acceleration. May not work correctly (or at all) with BTRFS filesystems on Unraid — see GitHub issues #299 and #720 for details. source

Fetched 37 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which environment variable selects the Windows version?

Set the VERSION environment variable, with 11 as the default. Other supported values include 10, 10l, 10e, 11l, 11e, and 8e.

Is the built-in web viewer suitable for everyday use?

It is mainly for the initial install and has low image quality, no audio, and no clipboard. For a better experience, connect with a Microsoft Remote Desktop client to the container IP using the username Docker.

Which ports should be exposed?

Expose port 8006 for the web interface and port 3389 over TCP and UDP for Remote Desktop.

Where should persistent Windows data be stored?

Mount a host folder to the container's /storage path, such as ./windows:/storage.

Which devices and capabilities are needed for KVM acceleration?

Pass /dev/kvm and /dev/net/tun to the container and add the NET_ADMIN capability.

Answers sourced from github.com, github.com

Community

Collected 48 days ago - public community threads