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-readyin the SSH identification line; no credentials are sent). A node with ZTP disabled is not affected. mise installtakes 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 upto join the node to your tailnet.