Skip to main content

Windows

There are two different Windows workflows:
  • Fased runs on this Windows PC: install and run it inside WSL2 Ubuntu.
  • Fased runs on a VPS: use native Windows Tailscale and SSH; Fased runs on the remote Linux VPS, not in Windows or WSL.
Fased Local requires Windows 11 or Windows 10 version 2004/build 19041 or newer. The wallet signer uses Unix sockets, so native Windows Node.js, PowerShell, Command Prompt, Git Bash, and WSL1 are not supported runtimes. The published npm package intentionally rejects native Windows with EBADPLATFORM; do not override npm’s platform check. WSL2 reports Linux and receives the supported Linux package and signer asset.

1. Administrator PowerShell

Open PowerShell with Run as administrator and run only these Windows setup commands:
Restart Windows if requested. WSL must be 0.67.6 or newer and the Ubuntu row must show VERSION 2.

2. Ubuntu WSL2 shell

Open Ubuntu from the Start menu and create its Linux username/password if prompted. Then run this separate block inside Ubuntu:
uname -s must print Linux; PID 1 must be systemd. Keep every later fased command in Ubuntu:
The dashboard opens in the normal Windows browser through WSL localhost forwarding.
In Administrator PowerShell, copy the exact distribution name shown by wsl --list --verbose, then convert it:
Inside Ubuntu, create or edit /etc/wsl.conf:
Close Ubuntu, run wsl --shutdown once in PowerShell, reopen Ubuntu, and check ps -p 1 -o comm= again. See Microsoft’s WSL systemd guide.
First-wallet setup downloads the version-matched Linux signer, verifies its checksum and release attestation, and installs it automatically. Users do not install Go.Local WSL2 runs Gateway and signer under the same Linux account. Keep Local wallet balances limited. VPS Hosting uses an independent signer account; hardware-backed Wallet Standard or a reviewed custody provider offers a stronger boundary for reserve funds.
Run the enrollment launcher inside Ubuntu:
Open its short-lived http://localhost:18791/... URL in the Windows browser. Do not create a Windows portproxy, LAN bind, firewall exposure, or public tunnel for the enrollment port.

Install

Local and VPS quick commands.

VPS Hosting

Private access and recovery.

Updating

Update Local WSL2 or a VPS runtime.

Microsoft WSL guide

Official Windows setup documentation.