Windows Client

The Windows GUI Client is designed for Windows computers where a user is present to authenticate with your identity provider interactively.

Prerequisites

• Windows 10 or higher
• x86-64 CPU
• WebView2 (The installer will install this automatically if needed)

Installation

Download the .msi installer from our releases page or from the direct link below:

• Download the Windows .msi installer for x86-64

After downloading, run the .msi to install the Firezone GUI Client.

Usage

Signing in

1. Run Firezone
2. At the Welcome screen, click Sign in. This will open the Firezone sign-in page in your default web browser.
3. Sign in using your account slug and identity provider.
4. If your browser asks whether it should open Firezone links, check Always allow and open the link.
5. When you see the "Firezone connected" notification, the tunnel is ready.

The Welcome screen only appears for your first sign-in. After that, you can use the tray menu to sign in.

Accessing a Resource

When Firezone is signed in, web browsers and other programs will automatically use it to securely connect to Resources.

To copy-paste the address of a Resource you have access to:

1. Right-click on the Firezone tray icon to open the menu.
2. Open a Resource's submenu and click on its address to copy it.

Quitting

1. Right-click on the Firezone tray icon to open the menu.
2. Click Disconnect and Quit or Quit.

The tunnel is now stopped. If you were signed in, the tunnel will restart next time you open Firezone.

Signing out

1. Right-click on the Firezone tray icon to open the menu.
2. Click Sign out.

The tunnel is now stopped until you sign in again.

Upgrading

The Windows Client will automatically check for updates on launch and prompt you to upgrade when a new version is available. Simply download the latest .msi installer package above, quit the GUI, and install it over the existing version.

Diagnostic logs

Firezone writes log files to disk. These logs stay on your computer and are not transmitted anywhere. If you encounter a bug, sending us a zip archive of your logs may help us fix the bug.

To export your logs as a zip archive, or clear your log directory:

1. Right-click on the Firezone tray icon to open the menu.
2. Click "Settings".
3. Click "Diagnostic Logs".

Uninstalling

1. Quit Firezone.
2. Open the Start Menu and search for Remove programs.
3. In the Add or remove programs dialog, search for Firezone.
4. Click on Firezone and click Uninstall.

Troubleshooting

TODO (reverting DNS, check if DNS is controlled)

Known issues

• Web browsers that use DNS-over-HTTPS by default may not work with Firezone. See this guide to disable DNS-over-HTTPS if you're experiencing issues connecting to DNS Resources within your browser.
• Firezone does not register itself with Windows as a VPN #2875
• After clearing diagnostic logs, no more logs are written until the GUI and tunnel service each restart. #4764
• In rare cases, Firezone gets stuck signing in #4765