Gateway
Don't forget to copy DEFGUARD_TOKEN necessary to start gateway connection from modal available on overview page under Docker run command
Binary Install
Checkout Gateway releases here and download compatible binary from Github page.
Decompress and move to bin directory
Start gateway
gateway -g defguard.com:50055 -t <DEFGUARD_TOKEN>
Package Install
On the release page find and download a correct software package for your system (currently DEB, RPM and TXZ are available).
Install the package using relevant system tools: Ubuntu/Debian:
Fedora/Red Hat Linux/SUSE:
FreeBSD:
Fill in the default configuration file (
/etc/defguard/gateway.toml
) with values corresponding to your Defguard installation (token and gRPC enpoint URL).Enable and start the systemd service.
Docker-compose
To start your gateway using docker-compose:
We prepared a git repository with docker-compose configuration, clone it:
Copy and fill in the .env file:
Finally, run the service with docker-compose:
If everything went well, your Gateway should be connected to Defguard and you can start adding new devices to your network.
SSL
You'll need a valid CA certificate to connect Gateway to Defguard. See SSL instructions.
OPNsense plugin
GitHub doesn't support FreeBSD runners - because of that it's hard to automate building/releasing the plugin (which is on freebsd).
Thus we have an issue that packages gateway are build with wrong architecture:
There is a workarond for that:
To start your gateway as OPNsense plugin:
On the release page find and download OPNsense package which will be named:
defguard-gateway_VERSION_x86_64-unknown-opnsense.txz
.Install the package
Refresh your OPNsense UI by running below command:
Go to you OPNsense UI and navigate
VPN
->Defguard Gateway
.
Fill form with appropriate values click
Save
thenStart/Restart
You can find detailed description of all fields here.
If everything went well, your Gateway should be connected to Defguard and you can start adding new devices to your network.
Last updated