Client Instructions | Docs Firezone Link Search Menu Expand Document

Client Instructions

Table of contents

  1. Table of contents
  2. Install and Setup
    1. Step 1 - Install the native WireGuard client
    2. Step 2 - Download the device config file
    3. Step 3 - Add the config to the client
  3. Re-authenticating your session
    1. Step 1 - Deactivate VPN session
    2. Step 2 - Re-authenticate
    3. Step 3 - Activate VPN session

This is written for the end user who will be connecting to the Firezone VPN server.

Install and Setup

Follow this guide to establish a VPN session through the WireGuard native client.

Step 1 - Install the native WireGuard client

Firezone is compatible with the official WireGuard clients found here:

For operating systems not listed above see the Official WireGuard site: https://www.wireguard.com/install/.

Step 2 - Download the device config file

The device config file can either be obtained from your Firezone administrator or self-generated via the Firezone portal.

To self generate a device config file, visit the domain provided by your Firezone administrator. This URL will be specific to your company (in this example it is https://firezone.example.com)

Firezone Okta SSO Login

Step 3 - Add the config to the client

Open the WireGuard client and import the .conf file. Activate the VPN session by toggling the Activate switch.

Activate Tunnel

Re-authenticating your session

If your network admin has required periodic authentication to maintain your VPN session, follow the steps below. You will need:

  • URL of the Firezone portal: Ask your Network Admin for the link.
  • Credentials: Your username and password should be provided by your Network Admin. If your company is using a Single Sign On provider (like Google or Okta), the Firezone portal will prompt you to authenticate via that provider.

Step 1 - Deactivate VPN session

WireGuard Deactivate

Step 2 - Re-authenticate

Visit the URL of your Firezone portal and sign in using credentials provided by your network admin. If you are already logged into the portal, click the Reauthenticate button, then sign in again.

re-authenticate

Step 3 - Activate VPN session

Activate Session