← Docs

Windows

Install and run Gold Lapel on Windows — native and WSL.

Install (PowerShell)

Run the PowerShell installer to download the Windows x86_64 binary:

irm https://goldlapel.com/install.ps1 | iex
goldlapel --version

The binary installs to C:\Program Files\goldlapel\ and is added to your PATH. Note that PowerShell uses double quotes for strings containing special characters — single quotes won't interpolate variables, which matters for connection strings.

Start the proxy

Run directly from PowerShell:

goldlapel --upstream "postgresql://goldlapel:password@localhost:5432/mydb"

WSL

If you're running Postgres inside WSL, install the Linux binary instead. The Linux install script works identically inside WSL:

# Inside WSL — same as Linux
curl -fsSL https://goldlapel.com/install.sh | sh
goldlapel --upstream 'postgresql://goldlapel:password@localhost:5432/mydb'

Run as a Windows service

For production, register Gold Lapel as a Windows service so it starts on boot:

# Install as a Windows service (run as Administrator)
sc.exe create GoldLapel binPath= "C:\Program Files\goldlapel\goldlapel.exe --config C:\ProgramData\goldlapel\goldlapel.toml" start= auto
sc.exe start GoldLapel

Next steps

  • Commands — subcommands, connection modes, TLS, replicas, failover
  • Configuration — dozens of settings — flags, env vars, TOML, and wrapper keys