Skip to content

Commit 18a0276

Browse files
defguard-communitygitbook-bot
authored andcommitted
GITBOOK-409: disable FW management on gateway
1 parent d01dc9b commit 18a0276

2 files changed

Lines changed: 18 additions & 0 deletions

File tree

configuration.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,15 @@ If you're using docker image you can pass this value as environmental variables
127127
* `DEFGUARD_GATEWAY_NAME`, `--name <NAME>` - (optional) human-readable gateway name that will be displayed in defguard webapp
128128
* `-s, --use-syslog` - enable logging to syslog
129129
* `RUST_LOG` : Logger log level, default: `info`, supported: `debug`, `warn`, `error`
130+
* `DEFGUARD_MASQUERADE` - controls whether the gateway automatically applies masquerade NAT firewall rule; defaults to `false`
131+
* `DEFGUARD_DISABLE_FW_MGMT` - disables all firewall management by the gateway; this overrides `DEFGUARD_MASQUERADE` setting; defaults to `false` \
132+
133+
134+
{% hint style="warning" %}
135+
`DEFGUARD_DISABLE_FW_MGMT` is meant as a workaround for running in incompatible environments, where our [default firewall integration](enterprise/all-enteprise-features/access-control-list/firewall-internals.md) is not supported.
136+
137+
As a consequence, enabling this option disables [ACL functionality](enterprise/all-enteprise-features/access-control-list/) on a given gateway.
138+
{% endhint %}
130139

131140
#### Executing custom commands on VPN up/down
132141

deployment-strategies/gateway/running-gateway-on-mikrotik-routers.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,14 @@ By leveraging the ability of some MikroTik routers to run Docker containers it i
66
Proceed with extra caution when working with your core infrastructure. All official [RouterOS containers warnings](https://help.mikrotik.com/docs/display/ROS/Container#Container-Disclaimer) still apply.
77
{% endhint %}
88

9+
{% hint style="danger" %}
10+
Running the gateway on a MikroTik router is not fully supported.
11+
12+
Due to custom RouterOS kernel incompatibility this kind of deployment does not support [Access Control List](../../enterprise/all-enteprise-features/access-control-list/) functionality.
13+
14+
To run the gateway you must explicitly disable firewall management using the [`DEFGUARD_DISABLE_FW_MGMT` option](../../configuration.md#gateway-configuration).
15+
{% endhint %}
16+
917
## Prerequisites
1018

1119
* RouterOS device with ARM or ARM64 architecture (popular homelab choices include RB4011 or RB5009)
@@ -79,6 +87,7 @@ Container port being forwarded to must match your public WireGuard port.
7987
```
8088
/container/envs/add name=defguard_env key=DEFGUARD_TOKEN value=<YOUR TOKEN>
8189
/container/envs/add name=defguard_env key=DEFGUARD_GRPC_URL value=<YOUR DEFGUARD GRPC URL>
90+
/container/envs/add name=defguard_env key=DEFGUARD_DISABLE_FW_MGMT value=true
8291
```
8392

8493
* (optional) to use SSL for communication between the gateway and your defguard instance copy the root certificate to your router's filesystem and add a following mount and environment variable:

0 commit comments

Comments
 (0)