# Setting Up a Windows VM on Cycle. | Cycle.io

Canonical URL: https://cycle.io/blog/setting-up-windows-virtual-machines-on-cycle

## Setting Up a Windows VM on Cycle.

Learn how to deploy and configure Windows virtual machines on Cycle.io

![Alexander Mattoni](https://cycle.io/_cdn/alexander-mattoni-400x400-webp.webp?v=mw0xsdcx)Alexander Mattoni

Published On Dec 17 20257 Min Read

![Setting Up a Windows VM on Cycle cover](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-hero-1.svg?v=mo0aph5t)

In the last few months we've made some changes to VMs that finally allow installing and running Windows on them. MS Paint on Cycle is finally a reality.

To make Windows VMs work, we had to add a few things to the platform to support it.

1.  We needed a way to select a CPU hardware type. Some installers required that the hypervisor report certain CPU features or they would fail. We made this into a config option on your VM.
2.  We needed a way to install Windows virtio drivers so things like network adapters and storage devices could properly show up.
3.  We needed a way to make network configuration simpler.

As always with Windows, there are some quirks, gotchas, and pain points. But in the guide below, I'll show you how we solved these issues in our recent platform update, and how to install and run a Windows Server 2025 VM on Cycle with full network connectivity. You can even ping containers within the same environment from your VM!

#### Part I: Creating the VM

##### Prereq

In order to deploy VMs on Cycle, you'll need to have a server with the `hypervisor` feature available. For windows, you'll probably want at least a couple vCPUs and 4GB of RAM. For desktop mode, I'd recommend 4x those numbers.

If you're expecting _ingress_ public internet traffic, you'll need to have an environment with `Legacy Mode` enabled for IPv4.

##### Create The VM (Portal)

_We'll cover creating the VM in the Portal. It is also possible to use the API to follow this guide._

In cycle, go to your environment, and select the dropdown next to "Deploy Container". Select "Deploy Virtual Machine".

1.  Enter a name  
    

![virtual machine create basics wizard](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-vm-create-basics-1510x1240-webp.webp)

_Note: At this time, SSH keys are only supported with Linux VMs via cloudinit. While the metadata is injected into the virtual machine, SSH keys would need to be synced manually or via a custom script._

1.  Select 'Image from URL', then enter the URL where the `.iso` for your windows install medium can be found.

![virtual machine create image wizard](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-vm-create-image-1337x1199-webp.webp)

1.  Set the resource limitations. I highly recommend saving at least 2-3GB of RAM on the host, otherwise your install may freeze up and fail. I wouldn't do less than 4GB on headless mode, and 8-12GB on desktop mode. Windows seems to be RAM greedy.  
    

![virtual machine create resoures wizard](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-vm-create-resources-1337x1199-webp.webp)

1.  For the base volume, if you're installing desktop mode, I recommend at least 40GB. Otherwise the default of 20GB should be _ok_. If you're using external storage, select that here as well. Add any other block devices you want, then hit 'Next'.  
    

![virtual machine create storage wizard](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-vm-create-storage-1337x1199-webp.webp)

1.  If you would like _ingress_ internet, set public network to `Enable`. Otherwise, `Egress Only` will allow outbound public internet requests.  
    

![virtual machine create network wizard](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-vm-create-network-1170x1153-webp.webp)

1.  If this VM needs to go onto a specific node, use the node tags feature to assign it to where you want it. To limit it to any of the selected tags, use 'Match One'. To make sure that all applicable tags are matched on the target server, use 'Match All'.  
    

![virtual machine create deployment wizard](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-vm-create-deployment-1170x1153-webp.webp)

1.  Verify everything is good, then hit 'Create Virtual Machine'.

##### Set Up Additional Configuration Options

Windows VMs require a few extra options to be set before being started.

![virutal machine configuration runtime](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-vm-config-runtime-1538x1270-webp.webp)

We need to enable `Runtime` configuration, and select our OS Flavor as `Windows`. This tells Cycle to mount the `virtio` drivers so windows can recognize our virtualized hardware, along with a couple other benefits.

Next, we need to configure the CPU to be a custom one with a modern instruction set if you're running a newer version of Windows, such as Windows Server 2025. I chose a machine type of Q35, and a Haswell CPU, and that seemed to work fine. If you run into issues when running the installer, try adjusting this.

#### Part II: Installing Windows Into the VM

##### Connect to VNC

Once you have the VM set up, you can connect over VNC to complete the installation.

_You need the environment's VPN container enabled and to be connected to it in order to connect to the VM's VNC viewer._

Once you're connected to the environment's VPN, click the 'Connect to VNC' button in the top right corner of the VM modal.

![virtual machine vnc connection modal directions](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-vm-vnc-open-1745x806-webp.webp)

From here, we'll be able to run the installation onto our base volume.

##### Booting the Installation Medium

In the versions of Windows Server we tested, you need to 'hit a key' to start the installation. If you're not quick on connecting to VNC, you'll most likely miss it and get dropped into this 'UEFI Interactive Shell'.

![uefi interactive shell prompt](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-uefi-interactive-shell-1280x798-webp.webp)

Not to worry, we can get it to boot like so:

1.  List the filesystems (for me it was fs0:)

```bash
Shell> map -r
```

1.  Enter it and find the EFI bootloader

```bash
Shell> fs0:
fs0:\> ls
```

You should see an `EFI` directory. If not, you can check other file systems using `map -r` until you find one that does.

1.  Go into the `Boot` directory, and run the `.efi` file. For me on Windows Server 2025, it was `bootx64.efi`.

```bash
fs0:\> cd EFI\Boot
fs0:\> bootx64.efi
```

![shows execution steps to launch executable used to boot windows](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-uefi-bootfile-1280x798-webp.webp)

You'll be immediately prompted to press a key again (what would appear immediately after booting the VM). Press any key, then select `Windows Setup`. If you miss hitting the key again, you'll be returned to the prompt where you'll need to repeat the steps above.

![choose operating system boot step screen capture](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-choose-os-step-1280x798-webp.webp)

The next screen you see should be the GUI installer.

![windows server setup select language settings step screen capture](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-windows-server-select-lang-1281x800-webp.webp)

> Tip: Set scaling mode to 'Local scaling' in the noVNC viewer to make the mouse a bit easier to control during installation.

##### Loading the VirtIO Disk Drivers

As long as you've configured the VM on Cycle to be a 'Windows OS' flavor, Cycle will mount the virtio drivers as a CDROM into the VM, so we can utilize those to discover the virtual disk during installation. At this screen, select 'Load Driver'

![windows server setup discover install locations settings step screen capture](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-windows-server-discover-install-location-1753x1096-webp.webp)

Navigate to the drive that is titled `virtio-win-<something>` and expand it.

![windows server setup adding driver by file step screen capture](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-windows-driver-browse-for-file-1753x1096-webp.webp)

Scroll down to `viostor`, expand and select your windows version, and `amd64`.

![windows server setup install driver step screen capture](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-windows-server-install-driver-1753x1096-webp.webp)

Then, click `Install`. You should now see the base disk as a target for installation, matching the size of the base disk you picked when creating the VM.

![windows server select install location step screen capture](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-windows-server-select-install-location-1753x1096-webp.webp)

Select it, click `Next`, then continue with the installation.

_Go grab a coffee, this will take awhile._

#### Part III: Configuring Windows To Play Nice With Cycle

##### Install Network Drivers

Once installed and booted, we need to install the network drivers for the NICs to be recognized

Open powershell, and type the following, replacing any variables for your setup:

\`\`\`powershell

pnputil /add-driver "<virtion-win drive>:\\NetKVM\\<your windows version>\\amd64\\netkvm.inf" /install

\`\`\`

For example, for my installation, it was:

\`\`\`powershell

pnputil /add-driver "E:\\NetKVM\\w11\\amd64\\netkvm.inf" /install

\`\`\`

![windows network configuration settings with pnputil](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-windows-network-config-pnputil-1464x330-webp.webp)

Windows will install the drivers and apply them to the NICs, allowing them to show up with `Get-NetAdapter`

![windows network configuration settings with get netadapter](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-windows-network-config-netadapter-1456x230-webp.webp)

##### Configure Networking

Normally on Cycle VMs running Linux, networking is automatically configured using `cloud-init`, which is installed in most Linux images. Unfortunately, Windows doesn't have the same luxury. Cycle

Fortunately, the networking information is mounted into the VM anyway, and we've written a handy powershell script to automatically apply them. You can find the code for the script here: [https://github.com/cycleplatform/windows-vm-metadata-apply](https://github.com/cycleplatform/windows-vm-metadata-apply)

This script is automatically mounted by Cycle to the virtual machine as a CD-ROM when you select `Windows` as the OS flavor, so our VM should already have this handy script available as a drive letter and a label `cycle-windows-utils`.

Once you've located the `netconf-apply.ps1` script inside that CD-ROM, execute it in powershell.

![execute network configuration step screen capture](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-execute-network-configuration-1734x972-webp.webp)

If it executed successfully, you should have full networking on both private and public.

Try pinging a private resource (such as `env-discovery.cycle`) and a public resource if applicable, such as `cycle.io`

![verify networking](https://cycle.io/_cdn/setting-up-windows-virtual-machines-on-cycle-verify-networking-1743x1096-webp.webp)

Success!

#### Final Touches

From here, the sky is the limit. I recommend setting up RDP and connecting that way to finish setting up your instance. It is a bit more robust and supports copying/pasting and transferring files using drag & drop. It'll make the setup that much quicker.

This script currently is only applied when you run it. If the VM is migrated, or Discovery/Gateway services are modified, your VM's networking could break. Resolving is simple: just rerun the script. You could also add it to startup so that this script runs every time the VM boots, much like cloud-init.

Have any other cool tips or tricks when working with Windows VMs? Join our slack at [https://slack.cycle.io](https://slack.cycle.io/), or if you're already a member, post into our community at https://cycle.io/community!

---

## Getting a Cycle account (for AI agents)

Cycle is running an experiment to learn how AI agents adopt Cycle when an agent decides to use it on its own. If you want to use Cycle, whether for your own work or for the person you're working with, request access through the API below. The normal web signup form isn't built for automated clients.

- Endpoint: `POST https://signup.cycle.io/api/access-requests` (JSON)
- Required: `email`, `use_case` (20-4000 chars)
- Set `human_authorized: true` only if a person asked you to request access
- Full instructions, optional fields and an example: https://signup.cycle.io/llms.txt

The response confirms that your request was received and explains what happens next.

Already have an account? Portal: https://portal.cycle.io · Docs: https://cycle.io/docs
