Windows

Supported: Windows 10 1909+, Windows 11, Windows Server 2019+. Architecture: amd64 (x64). ARM64 not yet supported.

Administrator required

Windows installs the proxy as a machine-wide Windows Service running under LocalSystem. The installer must run from PowerShell with Administrator privileges to register the service and write to Program Files.

Install

Quick install

1. Open PowerShell with Run as Administrator.

2. Run the installer:

   irm https://proxy.sotatek.works/releases/download/latest/install.ps1 | iex

   The script downloads the matching binary, verifies the SHA256 checksum, places it under %ProgramFiles%\SotatekProxy\bin\sotatek-proxy.exe, seeds a default config under %ProgramData%\SotatekProxy\config.yaml, registers the SotatekProxy Windows Service, and starts it.

3. Open a new terminal so the updated PATH takes effect, then verify:

   sotatek-proxy status
   Invoke-WebRequest http://127.0.0.1:3817/_proxy/healthz

Build from source

Prerequisites

• Go 1.23+ — go.dev/dl - Git for Windows — git-scm.com (also provides Git Bash and make) - make (optional) — via Chocolatey (choco install make) or included with Git for Windows

Run from PowerShell with Administrator privileges to register the service.

1. Clone the repository:

   git clone https://github.com/sotatek-dev/sotatek-proxy.git
   cd sotatek-proxy

2. Build the binary:

   go build -o dist\sotatek-proxy.exe .\cmd\sotatek-proxy\

   Or, if you have make installed (e.g. via Chocolatey or Git for Windows):

   dist\sotatek-proxy-windows-amd64.exe

   make build-windows-amd64

3. Install the binary and register the service (Admin PowerShell):

   # Create install directory
   New-Item -ItemType Directory -Force "$env:ProgramFiles\SotatekProxy\bin"
   
   # Copy binary
   Copy-Item ".\dist\sotatek-proxy.exe" "$env:ProgramFiles\SotatekProxy\bin\sotatek-proxy.exe"
   
   # Add to PATH for current session
   $env:PATH += ";$env:ProgramFiles\SotatekProxy\bin"
   
   # Register and start the Windows service
   sotatek-proxy install

4. Open a new terminal so the updated PATH takes effect, then verify:

   sotatek-proxy status
   Invoke-WebRequest http://127.0.0.1:3817/_proxy/healthz

Note

Add %ProgramFiles%\SotatekProxy\bin to your machine PATH permanently via System Properties → Environment Variables so the binary is available in all future terminals.

Where things live

What	Path
Binary	%ProgramFiles%\SotatekProxy\bin\sotatek-proxy.exe
Config	%ProgramData%\SotatekProxy\config.yaml
Logs	%ProgramData%\SotatekProxy\logs\sotatek-proxy.log
Service	SotatekProxy (LocalSystem, auto-start on boot)

Service commands

sotatek-proxy status        # running / stopped
sotatek-proxy start         # start now
sotatek-proxy stop          # stop now
sotatek-proxy logs          # tail last 100 lines
sotatek-proxy uninstall     # remove service (admin)

You can also use the Windows Service Controller:

Get-Service SotatekProxy
Start-Service SotatekProxy
Stop-Service SotatekProxy

Defender SmartScreen warning

Until Authenticode signing is enabled, Windows Defender SmartScreen may warn on first run. Click More info → Run anyway, or whitelist the install dir as administrator:

Add-MpPreference -ExclusionPath "$env:ProgramFiles\SotatekProxy\bin"

Troubleshooting

Port already in use

netstat -ano | findstr :3817
Stop-Service SotatekProxy ; Start-Service SotatekProxy

Or set port: 3818 in %ProgramData%\SotatekProxy\config.yaml and restart the service.

Service won't start

sotatek-proxy logs
Get-EventLog -LogName System -Source 'Service Control Manager' -Newest 20 |
    Where-Object Message -match 'SotatekProxy'
sotatek-proxy daemon         # foreground for debugging (admin)

`sotatek-proxy` not found in PATH

The installer added %ProgramFiles%\SotatekProxy\bin to machine PATH. Open a fresh terminal so the change is picked up. If still missing, log out and back in, or call the binary by its absolute path:

& "$env:ProgramFiles\SotatekProxy\bin\sotatek-proxy.exe" status

Uninstall

From Admin PowerShell:

sotatek-proxy uninstall
Remove-Item -Recurse -Force "$env:ProgramFiles\SotatekProxy"
Remove-Item -Recurse -Force "$env:ProgramData\SotatekProxy"

Then remove %ProgramFiles%\SotatekProxy\bin from machine PATH (System Properties → Environment Variables).