Hyper-V instead of WSL 2
The built-in Linux runtime as a Hyper-V virtual machine on Windows PCs without WSL 2, such as Windows Server.
Where Hyper-V is on and WSL 2 is not (Windows Server has no WSL 2), the same runtime runs as a Hyper-V virtual machine, the Mac's design on Hyper-V: the same pinned Ubuntu disk with Docker and gVisor, a cloud-init seed cua writes itself, and the same pipe. Spaces run under gVisor there, as on a Mac.
- Which one.
autouses WSL 2 when it works, and Hyper-V when it does not and Hyper-V can; a home keeps the engine it set up. Choose withruntime.windows_backendinconfig.toml(auto,wslorhyperv) orCUA_RUNTIME_WINDOWS_BACKEND. - Permission. Hyper-V is managed by administrators and the
Hyper-V Administratorsgroup;cua runtime doctorsays when this account is in neither. Windows 10 and 11 give the VM the built-in Default Switch. Windows Server has none, so the first setup makes a private switch and NAT (cua-runtime, 10.232.0.0/24) and needs an elevated session once. - Its own VM.
cua-runtime-<tag>, one per cua home, with a dynamic disk of up to 60 GB under<cua home>\runtimes\linux\hypervand an SSH key only your user can read. Docker is reached over that key through the pipe, never a TCP port. Remove host setup deletes the VM, its disk and (on Server) the switch. - Needs. Hyper-V (Windows Pro, Enterprise, Education or Server; not Home) and the OpenSSH client Windows ships.
See Local runtimes for the WSL 2 runtime.