Windows

Windows inside a Docker container, installed for you

  • ghcr.io/hsinghhira/windows:latest
  • v6.06
  • Updated 8 Nov 2026
  • port 6187
  • port 6188
  • port 6188
  • amd64
  • Others
  • 54.3k stars

Open the app

Web Viewer

http://localhost:6187/

About Windows

Run a full Windows computer on your home server. The app downloads Windows from Microsoft and installs it by itself; you watch it in your browser and use it there or with Remote Desktop. Each install gets its own Windows password instead of upstream's shared default "admin".

Features

  • Windows 11, 10, Server, LTSC and older versions back to Windows 95
  • Downloads and installs on its own, no ISO or clicks needed
  • Near-native speed with KVM
  • Choose the memory, processor cores and disk size
  • A shared folder between your server and Windows (drive Z)
  • Use it in the browser or with any Remote Desktop app

How to use

  1. Open Windows from your dashboard.
  2. Watch Windows install itself. It takes 10 to 30 minutes.
  3. Use Windows in the browser, or connect a Remote Desktop app to [ZIMAOS-IP-ADDRESS]:6188 with the user name and password from the app log.

Before you install

Your server must support KVM (Intel VT-x or AMD-V turned on in the BIOS), and needs at least 32 GB of free space. Pick the Windows you want in VERSION before the first start:

VERSION Windows VERSION Windows
11 11 Pro 2025 Server 2025
11l 11 LTSC 2022 Server 2022
11e 11 Enterprise 2019 Server 2019
10 10 Pro tiny11 Tiny11
10l 10 LTSC core11 Tiny11 Core
10e 10 Enterprise 7u 7 Ultimate
8e 8.1 Enterprise xp XP Professional

Set RAM_SIZE (up to 16G) and CPU_CORES to what your server can spare. Leave PASSWORD blank to get a random one; it is shown in the app log in the box marked CREDENTIALS and saved in the storage folder as icestore-password.txt. Windows takes the user name, password, language and the other setup settings only while it installs, so set them first; change the password later inside Windows. More settings, like language and keyboard, are in the Variables tab; add them in the app settings.

The web viewer has no password of its own: anyone on your network who opens port 6187 sees the Windows screen. For daily use, Remote Desktop on port 6188 is faster and has clipboard and sound. This app is for amd64 servers only.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone. Leave it unless you need another.
VERSION11Which Windows to download and install. 11 is Windows 11 Pro. Others: 11l (11 LTSC), 10 (10 Pro), 10l (10 LTSC), 2025 or 2022 (Server), tiny11, xp, 7u. The full list is on the Windows page in IceStore. Pick it before the first start.
RAM_SIZE4GMemory for Windows, like 4G or 8G. Keep it below the memory your ZimaOS box has free, and below 16G.
CPU_CORES2How many processor cores Windows may use, like 2 or 4.
DISK_SIZE64GThe size of the Windows disk, like 64G or 128G. You can make it bigger later; then extend the C drive in Windows Disk Management.
USERNAMEDockerThe Windows user made when Windows installs. Pick it before the first start.
PASSWORD—The password of that user, used when Windows installs. Leave it blank and the app makes a random one, shown in the app log in the box marked CREDENTIALS. Change it later inside Windows.

Windows setup

VariableDefault valueDescription
LANGUAGEEnglishThe Windows language, like French, German or Spanish. Read only when Windows installs.
REGION—The region and number format, like en-US or en-GB. Leave it out to match the language.
KEYBOARD—The keyboard layout, like en-US or de-DE. Leave it out to match the language.
EDITION—A different edition of the chosen version, when it has several. Leave it out for the normal one.
KEY—Your Windows product key. Leave it out to install without one.
COMMAND—One Windows command to run at the end of the install, like a reg add line.
WORKGROUP—The Windows workgroup name. Leave it out for WORKGROUP.

Active Directory

VariableDefault valueDescription
DOMAIN—Join this Active Directory domain while installing, like example.com. USERNAME and PASSWORD must then be a domain account.
DOMAIN_OU—Where to put the computer in the domain, like OU=Computers,DC=example,DC=com.

Screen and sound

VariableDefault valueDescription
AUDIONSet to Y to hear Windows sound in the web viewer. Then turn on Audio under Settings, Advanced in the viewer. Remote Desktop has sound without this.
WIDTH—Screen width in pixels, like 1920. Set HEIGHT too.
HEIGHT—Screen height in pixels, like 1080. Set WIDTH too.

Logs

VariableDefault valueDescription
DEBUGNSet to Y for more detail in the app log.
docker-compose.yml
name: windows

services:
  windows:
    image: ghcr.io/hsinghhira/windows:latest
    container_name: windows
    restart: unless-stopped
    stop_grace_period: 2m
    network_mode: bridge
    cap_add:
      - NET_ADMIN
    devices:
      - /dev/kvm:/dev/kvm
      - /dev/net/tun:/dev/net/tun
    environment:
      - TZ=$TZ
      - VERSION=11
      - RAM_SIZE=4G
      - CPU_CORES=2
      - DISK_SIZE=64G
      - USERNAME=Docker
      - PASSWORD=
    ports:
      - target: 8006
        published: "6187"
        protocol: tcp
      - target: 3389
        published: "6188"
        protocol: tcp
      - target: 3389
        published: "6188"
        protocol: udp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/storage
        target: /storage
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/AppData/$AppID/shared
        target: /shared
        bind:
          create_host_path: true
    deploy:
      resources:
        limits:
          cpus: "4.00"
          memory: 16384M
        reservations:
          cpus: "0.50"
          memory: 2048M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/windows/icon.png
    x-casaos:
      id: com.icestore.windows
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
              Leave it unless you need another.
        - container: VERSION
          description:
            en_US: >-
              Which Windows to download and install. 11 is Windows 11 Pro.
              Others: 11l (11 LTSC), 10 (10 Pro), 10l (10 LTSC), 2025 or
              2022 (Server), tiny11, xp, 7u. The full list is on the Windows
              page in IceStore. Pick it before the first start.
        - container: RAM_SIZE
          description:
            en_US: >-
              Memory for Windows, like 4G or 8G. Keep it below the memory
              your ZimaOS box has free, and below 16G.
        - container: CPU_CORES
          description:
            en_US: >-
              How many processor cores Windows may use, like 2 or 4.
        - container: DISK_SIZE
          description:
            en_US: >-
              The size of the Windows disk, like 64G or 128G. You can make it
              bigger later; then extend the C drive in Windows Disk
              Management.
        - container: USERNAME
          description:
            en_US: >-
              The Windows user made when Windows installs. Pick it before the
              first start.
        - container: PASSWORD
          description:
            en_US: >-
              The password of that user, used when Windows installs. Leave it
              blank and the app makes a random one, shown in the app log in
              the box marked CREDENTIALS. Change it later inside Windows.
      ports:
        - container: "8006"
          description:
            en_US: Web viewer (the Windows screen in your browser), published on host as 6187
        - container: "3389"
          description:
            en_US: Remote Desktop (RDP), TCP and UDP, published on host as 6188
      volumes:
        - container: /storage
          description:
            en_US: >-
              The Windows disk, the downloaded installer and
              icestore-password.txt. Needs at least 32 GB free, more for a
              bigger DISK_SIZE.
        - container: /shared
          description:
            en_US: >-
              A folder shared with Windows. It shows as Shared on the desktop
              and as drive Z.

x-casaos:
  id: com.icestore.windows
  architectures:
    - amd64
  main: windows
  author: HSinghHira
  category: Others
  developer: dockur
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/windows/icon.png
  title:
    en_US: Windows
  tagline:
    en_US: Windows inside a Docker container, installed for you
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/windows/](https://icestore.hsinghhira.me/app/windows/) for full details


      Run a full Windows computer on your ZimaOS box. The app downloads
      Windows from Microsoft and installs it by itself; you watch it in your
      browser and use it there or with Remote Desktop. Each install gets its
      own Windows password instead of the shared default "admin".


      **Features**


      - Windows 11, 10, Server, LTSC and older versions back to Windows 95

      - Downloads and installs on its own, no ISO or clicks needed

      - Near-native speed with KVM

      - Choose the memory, processor cores and disk size

      - A shared folder between ZimaOS and Windows (drive Z)

      - Use it in the browser or with any Remote Desktop app


      **How to use?**


      1. Open Windows from the Zima OS dashboard.


      2. Watch Windows install itself. It takes 10 to 30 minutes.


      3. Use Windows in the browser, or connect a Remote Desktop app to
         [ZIMAOS-IP-ADDRESS]:6188 with the user name and password from the
         app log.
  tips:
    before_install:
      en_US: >-
        1. Your ZimaOS box must support KVM (Intel VT-x or AMD-V turned on in
           the BIOS). Without it Windows will not start.


        2. Make sure there is at least 32 GB of free space, more if you pick
           a bigger DISK_SIZE.


        3. Pick the Windows you want in VERSION. 11 is Windows 11 Pro.


        4. Set RAM_SIZE and CPU_CORES. 4G and 2 is fine to start.


        5. Leave PASSWORD blank to get a random one. Or type your own.


        6. More settings, like language and keyboard, are listed on the
           Windows page at https://icestore.hsinghhira.me/app/windows/
           (Variables tab). Add them now. Windows only reads them when it
           installs.


        7. Start the installation.


        8. Open Windows from the Zima OS dashboard. Watch it download and
           install. This takes 10 to 30 minutes.


        9. Open the app log. Find the box marked CREDENTIALS. It has your
           user name and password.


        10. For a faster screen, use a Remote Desktop app. Connect to
            [ZIMAOS-IP-ADDRESS]:6188, like 192.168.1.20:6188.
  index: /
  port_map: "6187"
  scheme: http
  is_uncontrolled: false
  version: "6.06"
  update_at: "2026-11-08"
  release_notes:
    en_US: |-
      - First IceStore version, built on dockurr/windows 6.06
      - Each install gets its own Windows password (upstream's default is "admin")
      - Web viewer on 6187, Remote Desktop on 6188 (TCP and UDP)
      - amd64 only; ARM boxes need dockur/windows-arm
  repo: "https://github.com/dockur/windows"
  support: "https://github.com/dockur/windows/issues"
  docs: "https://github.com/dockur/windows#faq-"

Install Windows

Something not working with Windows?

Report it so it gets fixed, or ask for an app that is not here yet.

More Others apps

See all