Skip to content

Devbox Windows

Devboxes are nodes with a common set of tooling pre-installed. Devbox Windows is a Windows 11 Enterprise developer workstation with cloudbase-init, OpenSSH Server and mise for managing developer tools.

Base Image

Microsoft does not provide ready built qcow2 images so you will need to build them yourself. You can use this packer template to build a Windows 11 Enterprise Evaluation image with cloudbase-init, an SSH server and the devbox tooling.

Sherpa runs Devbox Windows on SeaBIOS without a TPM or Secure Boot. The packer template builds the image for that hardware, so other Windows 11 images may not boot.

Import Image

sherpa server image import \
  --src /some/path/<image_name>.qcow2 \
  --version windows11-20261029 \
  --model devbox_windows \
  --default

Default Node Parameters

Property Value
Kind Virtual Machine
Tested Version windows11-20261029
CPU 4
RAM 8GB
CDROM Driver SATA
DISK virtioa.qcow2
DISK Driver virtio
ZTP cloud-init
Management Interface eth0
Data Interfaces eth1
Interface Driver virtio

Example Manifest

name = "devbox-windows"

[[nodes]]
name = "dev01"
model = "devbox_windows"

Accounts

Your account is the node's only enabled login, as on Windows Server: the image's built-in Administrator and cloudbase-init's Admin are disabled at first boot.

Node Access

sherpa ssh dev01
sherpa console dev01

Developer Tools

The image installs mise for all users, with the devbox tool selections in C:\ProgramData\mise\config.toml. The tools are installed per user, so run mise install once after the first login:

mise install

This installs Node.js LTS, Rust (MSVC toolchain), GitHub CLI, Packer, Terraform, Azure CLI, uv, ruff, ty, Claude Code, Codex, OpenCode, Pi and Herdr into the user's %LOCALAPPDATA%\mise. Update them with mise upgrade.

Git for Windows, the Visual Studio C++ Build Tools, AWS CLI, Tailscale and Proton Pass CLI are installed for all users, as mise cannot manage them on Windows.

Notes

  • Approximate time for the system to be ready: 5 minutes. SSH answers after about 3.5 minutes; cloudbase-init then reboots once to apply the hostname, which can close an early session.
  • With cloud-init ZTP, Sherpa reports the node ready only once its SSH server runs with the config Sherpa gave it, after cloudbase-init has created your account and written your keys (VersionAddendum sherpa-ready in the SSH identification line; no credentials are sent). A node with ZTP disabled is not affected.
  • mise install takes about 8 minutes on first run.
  • The Windows 11 Enterprise Evaluation expires 90 days after the image is built.
  • Docker, QEMU/KVM and other tools from Devbox Linux that need nested virtualization or have no Windows release are not included.
  • Run tailscale up to join the node to your tailnet.