LogrusLogrus

Installing the Windows client

Download the installer, get past SmartScreen and the admin prompt, sign in, and hit Connect.

Which file to download

The Download page offers three different Windows builds:

  • Logrus-setup-v<version>.exe — the regular installer. This is the one you want.
  • Logrus-portable-v<version>.exe — no installation, for a USB stick or a machine where you cannot install software.
  • logrus-client-v<version>-windows-amd64.exe — the headless command-line client, for scripts and servers.

64-bit Windows only. It runs on ARM laptops through x64 emulation.

Steps

  1. Run Logrus-setup-v<version>.exe. Our Windows builds are not code-signed, so SmartScreen will warn you — "More info" → "Run anyway".
  2. The installer asks for administrator rights. This is not optional: Logrus creates a kernel-level network adapter (wintun), which is a privileged operation.
  3. The default directory is C:\Program Files\Logrus.
  4. Sign in: email and password, Google, a passphrase, or a QR code from a second device where you are already signed in ("Other ways" on the sign-in screen).
  5. Hit Connect.

About the admin prompt on every launch

This is expected and cannot be turned off. Logrus has no background service on Windows: the app edits the routing table and opens the wintun adapter itself, so the UAC dialog appears every time it starts — from the Start menu and right after installation alike.

The installer also enables and resynchronises the Windows time service. A drifted clock breaks TLS certificate validation and access-token signatures, and it presents as an unexplained connection failure.

If it doesn't work

  • The app doesn't start at all, no window ever appears — check that your antivirus hasn't quarantined Logrus.exe, then reinstall over the top: the installer also lays down libraries a clean system may be missing.
  • The tunnel won't come up — open Settings → About → Log. It shows the step it stopped on.
  • Slow first connection — the client is iterating through transports and measuring servers. After that, connecting takes a couple of seconds.

Sending logs

Support → Contact support, and tick "Attach recent logs". The last ~500 lines of logrus.log go with the ticket — those are application logs, not a history of the sites you visited. The reply comes to your account email.

Uninstalling

Uninstalling properly through Settings → Apps restores your system DNS and proxy settings. Do not delete the program folder by hand: that leaves the system pointing at a DNS resolver that no longer exists.