Instance configuration

In this guide, you will learn how to add, remove and update Instance in Defguard desktop client.

Defguard Desktop Client is required if you want to use Multi-Factor Authentication, as any other WireGuard client doesn't support this functionality.

Obtaining URL and Token

If you are looking for how to generate tokens for your users as an Administrator, look here:

Adding client device

1. Log in to your Defguard account.

2. Go to My Profile tab and select Devices tab.

1. Click Add new device button.

1. Click Client Activation.

1. Afterwards, use One-Click Configuration or click Show advanced configuration and copy URL and Token manually.

Manually Adding Instance

1. If you don't have Defguard in full view mode, open Defguard from tray view, and click Open Defguard

1. Click Add Instance.

1. Enter URL, Token and Device name of your choice, then click Add Instance. (If you don't have URL/Token, check out this section)

One-click Desktop Configuration

You can skip the whole process of entering the token/URL by clicking "One-Click Desktop Configuration". Here is a video describing the whole process:

Connecting to Instance

Desktop client in full view mode

1. Go to Instances

1. Select the instance you want to use

1. Choose allowed traffic

• Predefined traffic only will only route traffic specified by your administrator.

• All traffic is allowed will route everything through VPN tunnel.

1. Click Connect VPN

Desktop client in tray view mode

1. Click on instance list

1. Select the instance you want to connect to

1. Choose allowed traffic

• Predefined traffic only will only route traffic specified by your administrator.

• All traffic is allowed will route everything through VPN tunnel.

1. Click Connect VPN

Disconnecting from Instance

Click Disconnect next to the location you are currently connected to.

Updating Instance

If you want to update your instance manually:

1. If you don't have Defguard in full view mode, open Defguard from tray view, and click Open Defguard

1. Go to your Instance and click Instance settings

1. Click Update

Only tokens issued from that specific instance will work.

1. Enter Token provided by your administrator, or generate it on your own. Then click Update

Your Instance will update immediately.

Why do instances need updates?

Defguard Desktop stores all information locally and doesn't communicate with Defguard outside the registration process. This means that the information about an instance is a snapshot of the moment you registered it in the desktop client, and you might want to update it, for example when locations are added or removed.

If you have a Business or Enterprise plan, all desktop clients and all instances are synchronized automatically and in real-time.

Removing Instance

1. If you don't have Defguard in full view mode, open Defguard from tray view, and click Open Defguard

1. Go to your Instance, click Instance settings

1. Click Delete

1. Confirm with Delete instance button

Your Instance will be removed immediately.