---
title: "Deploy Windows Desktop"
description: "Run Windows Server, 11 or 10 in a browser tab or over Remote Desktop."
category: "Other"
url: https://railway.com/deploy/windows-desktop
---

# Deploy Windows Desktop

Run Windows Server, 11 or 10 in a browser tab or over Remote Desktop.

**[Deploy Windows Desktop on Railway](https://railway.com/template/windows-desktop)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/windows-desktop/manifest.json

- **Creator:** blueorange
- **Category:** Other

## Template content

### windows https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/microsoft-windows.svg

- **Image:** ghcr.io/two-workspaces/windows:9e7807a
- **Health check:** /healthcheck
- **Public domain:** Yes

## Documentation

# Deploy and Host Windows Desktop on Railway

![Windows logo](https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/microsoft-windows.svg)

This template runs a **full Windows desktop in a virtual machine** on Railway and streams it to your browser, with Remote Desktop (RDP) access as well. Choose Windows Server 2022, 2025 or 2019, Windows 11 or 10, or the LTSC editions. On first boot it downloads the official installer from Microsoft and installs Windows unattended, then you sign in from any device and get a normal desktop with Edge, PowerShell and anything you install, kept on a persistent volume. It is built on dockur/windows, an MIT-licensed project with about 54,000 GitHub stars that packages Windows in QEMU; this template uses its v6.06 release. Railway has no hardware virtualization, so the CPU is emulated and Windows runs several times slower than on a real PC. **It needs a Railway Pro plan** for the memory and disk Windows requires. Windows 365 Business cloud PCs start at about $29–36 per user per month.

---

## What This Template Deploys

| Service | Purpose |
|---|---|
| **Windows** | `ghcr.io/two-workspaces/windows`, built on `dockurr/windows:6.06`. QEMU runs Windows, a noVNC web viewer serves the desktop on port `8006` with a public domain, and a TCP proxy exposes RDP on port `3389`. Health check on `/healthcheck`. |
| **Persistent Volume** | Mounted at `/storage`. Holds the Windows virtual disk, so installed software, files and settings survive redeploys. |

A start-up check confirms the service has enough memory and disk before launching Windows. On a plan that is too small it shows a page explaining what is missing instead of crashing.

---

## About Hosting Windows Desktop

Many people only need Windows now and then: a Windows-only tool, a quick test in Edge, an old business app, or a scheduled script. Buying a PC or a Windows cloud subscription for that is overkill. This template gives you a disposable or long-lived Windows machine that you control, reachable from a Mac, Linux machine, Chromebook or tablet.

**Desktop in the browser.** Open your Railway domain, sign in, and use Windows in a browser tab with no client to install.

**Remote Desktop.** Connect any RDP client, such as Microsoft's Windows App, through the TCP proxy. RDP feels faster than the browser view and supports clipboard sharing.

**Choice of versions.** Windows Server 2022 (default), 2025 or 2019, Windows 11 or 10, and the 11 and 10 LTSC editions.

**Unattended install.** The installer is downloaded straight from Microsoft and Windows sets itself up with your username and password, with no setup screens to click through.

**Persistent disk.** The virtual disk lives on the volume and only grows as Windows writes data, so your apps and files stay between restarts.

**Protected access.** Both the web viewer and RDP require the Windows account from `USERNAME` and `PASSWORD`, with a strong password generated for you.

---

## Deploy Windows Desktop in Under 5 Minutes

1. Make sure your workspace is on **Railway Pro**, then click **Deploy on Railway**.
2. Optional: set `VERSION` before the first boot, for example `11` for Windows 11.
3. Open the public domain and sign in with `USERNAME` and `PASSWORD` from the **Variables** tab.
4. Watch the download and install progress. Under emulation the first install takes roughly 30 to 90 minutes; **do not redeploy or restart** while it runs, or it starts over.
5. When the desktop appears, start using Windows, or connect over RDP using the TCP proxy address under **Settings, Networking**.

---

## Common Use Cases

- **Windows-only software:** run a utility, accounting tool or legacy app without a Windows PC.
- **Browser testing:** check how a website behaves in Edge on Windows from a Mac or Linux machine.
- **Scheduled tasks:** keep a small always-on Windows box for PowerShell scripts or Task Scheduler jobs.
- **Windows Server labs:** try IIS, Active Directory tools or Server features in a throwaway environment.
- **Chromebook and tablet users:** reach a Windows desktop from a device that cannot run it.
- **Training and demos:** give a workshop a clean Windows machine and reset it afterwards.
- **File conversions:** run Windows-only converters or Office macros on demand.

---

## Configuration

| Variable | Required | Default | Description |
|---|---|---|---|
| `USERNAME` | Required | `admin` | Windows account and web login name |
| `PASSWORD` | 🔐 Auto-generated | `Win-` plus a secret | Windows account and web login password |
| `VERSION` | Optional | `2022` | Windows to install on first boot: `2022`, `2025`, `2019`, `11`, `10`, `11l` or `10l` |
| `RAM_SIZE` | Optional | `4G` | Memory for Windows; the service needs this plus about 2 GB |
| `CPU_CORES` | Optional | `4` | Virtual CPU cores for Windows |
| `PORT` | Required | `8006` | Web viewer port; do not change |
| `RAILWAY_DEPLOYMENT_DRAINING_SECONDS` | Required | `120` | Time Windows gets to shut down cleanly on redeploy |

**Resources.** Windows needs `RAM_SIZE` plus about 2 GB of memory and about 30 GB of disk for the first install. Pro volumes start at 50 GB, which gives a Windows disk of about 38 GB. For more space, resize the volume, set `DISK_SIZE` (for example `120G`), restart, and extend the C: drive in Disk Management.

**Changing versions.** `VERSION` only applies to the first install. To switch later, clear the files on the volume so a fresh install runs.

**Shutting down safely.** Shut Windows down from the Start menu before restarting the deployment. A redeploy gives Windows two minutes to shut down, but Railway's **Restart** stops it within seconds, like pulling the plug. After a Start menu shutdown the service idles on a small page, and a deployment restart boots Windows again.

**Cost control.** An always-on Windows VM uses about 6 GB of memory and busy CPU cores, so expect roughly $70–150/month on Railway if it runs around the clock. Shut it down when idle to pay far less.

---

## Licensing and Limits

Windows is downloaded from Microsoft as an evaluation edition: Server editions run for 180 days and Enterprise editions for 90 days unless you activate them with your own license key. You are responsible for licensing the copy you run.

CPU emulation makes Windows several times slower than a real PC, so it is fine for light apps and tests but not for gaming or heavy work. There is no GPU, no USB passthrough, and no nested virtualization, so WSL 2 and Hyper-V will not run.

---

## Windows Desktop vs. Alternatives

| Feature | Windows on Railway | Windows 365 Business | Amazon WorkSpaces | Windows VPS |
|---|---|---|---|---|
| Hosting | Your Railway project | Microsoft cloud | AWS cloud | Hosting provider |
| Software license | Evaluation or your key | Included | Included | Usually included |
| Browser access | ✅ | ✅ | ✅ | Varies |
| RDP access | ✅ | ✅ | Via client | ✅ |
| Hardware virtualization | ❌ emulated CPU | ✅ | ✅ | ✅ |
| Choose Server or client Windows | ✅ | Client only | ✅ | Usually Server |
| Price | Usage-based; pay little when shut down | About $29–36/user/month | About $33–44/month | Varies by provider |

Windows 365 and WorkSpaces are faster and include licensing. A Windows VPS gives native speed at a fixed price. This template suits occasional, flexible use inside a Railway project you already run.

---

## Dependencies for Windows Desktop Hosting

- A Railway **Pro** plan for enough memory and a 50 GB volume.
- Optional: an RDP client and a Windows license key.

### Deployment Dependencies

- [dockur/windows on GitHub](https://github.com/dockur/windows): the QEMU Windows container
- [Windows evaluation center](https://www.microsoft.com/en-us/evalcenter): Microsoft's evaluation editions
- [Windows App](https://learn.microsoft.com/en-us/windows-app/): Microsoft's Remote Desktop client

### Implementation Details

The image runs dockur/windows 6.06 with KVM off, password protection on the web viewer, and a disk that grows as Windows writes. A pinned image tag means redeploys never change versions by surprise. Windows is a trademark of Microsoft; this community template is not affiliated with Microsoft or the dockur project.

---

## Frequently Asked Questions

**What does this template run?**
A full Windows desktop in a QEMU virtual machine, reachable in your browser or over Remote Desktop.

**How much does it cost?**
It needs Railway Pro. Running all day costs roughly $70–150/month in usage; shutting Windows down when idle costs far less.

**Why does the first boot take so long?**
Windows downloads and installs under CPU emulation, which takes roughly 30 to 90 minutes. Later boots go straight to the desktop.

**How do I connect with Remote Desktop?**
Use the TCP proxy address under **Settings, Networking** with your `USERNAME` and `PASSWORD`.

**Do I need a Windows license?**
The evaluation editions run for 90 or 180 days. Activate with your own key to keep using Windows legally.

**Can I play games or run WSL 2?**
No. There is no GPU or hardware virtualization, so games, WSL 2 and Hyper-V will not run.

---

## Why Deploy and Host Windows Desktop on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Windows Desktop on Railway, you get a Windows machine you can reach from any browser or RDP client, with your files on a persistent volume and no hardware to buy.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/windows-desktop
