Ask AI about this page

Install the Windows .exe

A native subsimail.exe build for running SubsiMail directly on a Windows machine or server, no WSL or Docker Desktop required.

Download for Windows

Run it

Put subsimail.exe in its own folder (it creates a data\ subfolder next to itself for its database) and run it from PowerShell or Command Prompt:

.\subsimail.exe
Windows terminal running subsimail.exe
subsimail.exe starting up in PowerShell

It listens on port 3000 by default. Open http://localhost:3000 (or your server's address) to continue with first-run setup.

Windows SmartScreen warning

The .exe isn't code-signed, so Windows Defender SmartScreen will show an "unrecognized app" warning the first time you run it. Click More info → Run anyway to proceed. This is expected for a self-hosted tool distributed outside the Microsoft Store — it's not a sign of malware, just an unsigned binary.

Environment variables

Set these before launching, in PowerShell:

$env:PORT = "3000"
$env:RUST_LOG = "info"
.\subsimail.exe

Running IIS or another reverse proxy in front of SubsiMail on Windows? Also set $env:TRUSTED_PROXY = "true" — otherwise every visitor is logged as the proxy's own IP instead of the real one. See Reverse proxy & SSL.

Keeping it running

Closing the terminal window stops the server. For a machine that needs SubsiMail always on, either:

  • Run it on Windows Server and register it as a service with a wrapper like NSSM, or
  • Use Task Scheduler with a trigger of "At startup" pointed at subsimail.exe

Both are standard ways to keep any long-running .exe alive on Windows — nothing SubsiMail-specific about the setup.