# dockur/windows architecture

> Architecture diagram of the GitHub repository dockur/windows, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dockur/windows
- Repository: https://github.com/dockur/windows

## Overview

Dockur Windows runs a Windows installation as a Docker container. Users configure and start the container, select a Windows release, and let it download and install automatically; they then access the guest through the browser viewer or RDP. The README also documents resource allocation, KVM acceleration, storage and folder sharing, USB passthrough, and several networking modes. Source excerpts were not available, so relationships below are limited to documented behavior; implementation details and ownership within `src/` cannot be verified.

Main entry points: [`src`](https://github.com/dockur/windows/tree/master/src) (Windows guest)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provision["Provisioning"]
  node_container["Windows container"]
  node_selection["Release selection"]
  node_download["Automatic download"]
  node_install["Hands-free installation"]
end

subgraph group_runtime["Guest runtime"]
  node_guest["Windows guest"]
  node_kvm["KVM acceleration"]
  node_resources["CPU and memory"]
  node_balloon["Memory ballooning"]
  node_disk[("Persistent disk")]
  node_usb["USB passthrough"]
end

subgraph group_access["Access and integration"]
  node_sharing["Host folder sharing"]
  node_network["Container networking"]
  node_viewer["Web viewer"]
end

node_user(("Container operator"))
node_rdp(("RDP client"))
node_host(("Host machine"))

node_user -->|"starts"| node_container
node_user -->|"configures version"| node_selection
node_selection -->|"selects release"| node_download
node_download -->|"enables"| node_install
node_install -->|"installs Windows"| node_guest
node_container -->|"runs"| node_guest
node_guest -->|"uses acceleration"| node_kvm
node_user -->|"configures"| node_resources
node_guest -->|"supports"| node_balloon
node_guest -->|"persists to"| node_disk
node_host -->|"shares folder"| node_sharing
node_sharing -->|"exposes files"| node_guest
node_host -->|"provides device"| node_usb
node_container -->|"supports modes"| node_network
node_user -->|"connects by browser"| node_viewer
node_viewer -->|"accesses desktop"| node_guest
node_rdp -->|"connects by RDP"| node_guest

click node_container "https://github.com/dockur/windows/tree/master/src"
click node_selection "https://github.com/dockur/windows/tree/master/src"
click node_download "https://github.com/dockur/windows/tree/master/src"
click node_install "https://github.com/dockur/windows/tree/master/src"
click node_guest "https://github.com/dockur/windows/tree/master/src"
click node_resources "https://github.com/dockur/windows/tree/master/src"
click node_balloon "https://github.com/dockur/windows/tree/master/src"
click node_disk "https://github.com/dockur/windows/tree/master/src"
click node_usb "https://github.com/dockur/windows/tree/master/src"
click node_sharing "https://github.com/dockur/windows/tree/master/src"
click node_network "https://github.com/dockur/windows/tree/master/src"
click node_viewer "https://github.com/dockur/windows/tree/master/src"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_container,node_selection,node_download,node_install,node_rdp toneBlue
class node_guest,node_kvm,node_resources,node_balloon,node_disk,node_usb toneAmber
class node_sharing,node_network,node_viewer toneMint
class node_user,node_host toneIndigo
```

## Components

### Provisioning

- [Windows container](https://github.com/dockur/windows/tree/master/src): `src`
- [Release selection](https://github.com/dockur/windows/tree/master/src): `src`
- [Automatic download](https://github.com/dockur/windows/tree/master/src): `src`
- [Hands-free installation](https://github.com/dockur/windows/tree/master/src): `src`

### Guest runtime

- [Windows guest](https://github.com/dockur/windows/tree/master/src): `src`
- **KVM acceleration**
- [CPU and memory](https://github.com/dockur/windows/tree/master/src): `src`
- [Memory ballooning](https://github.com/dockur/windows/tree/master/src): `src`
- [Persistent disk](https://github.com/dockur/windows/tree/master/src): `src`
- [USB passthrough](https://github.com/dockur/windows/tree/master/src): `src`

### Access and integration

- [Host folder sharing](https://github.com/dockur/windows/tree/master/src): `src`
- [Container networking](https://github.com/dockur/windows/tree/master/src): `src`
- [Web viewer](https://github.com/dockur/windows/tree/master/src): `src`

### Other components

- **Container operator**
- **RDP client**
- **Host machine**

## Connections

- Container operator → Windows container: starts (evidence: `readme.md`)
- Container operator → Release selection: configures version (evidence: `readme.md`)
- Release selection → Automatic download: selects release (evidence: `readme.md`)
- Automatic download → Hands-free installation: enables (evidence: `readme.md`)
- Hands-free installation → Windows guest: installs Windows (evidence: `readme.md`)
- Windows container → Windows guest: runs (evidence: `readme.md`)
- Windows guest → KVM acceleration: uses acceleration (evidence: `readme.md`)
- Container operator → CPU and memory: configures (evidence: `readme.md`)
- Windows guest → Memory ballooning: supports (evidence: `readme.md`)
- Windows guest → Persistent disk: persists to (evidence: `readme.md`)
- Host machine → Host folder sharing: shares folder (evidence: `readme.md`)
- Host folder sharing → Windows guest: exposes files (evidence: `readme.md`)
- Host machine → USB passthrough: provides device (evidence: `readme.md`)
- Windows container → Container networking: supports modes (evidence: `readme.md`)
- Container operator → Web viewer: connects by browser (evidence: `readme.md`)
- Web viewer → Windows guest: accesses desktop (evidence: `readme.md`)
- RDP client → Windows guest: connects by RDP (evidence: `readme.md`)
