Skip to content

Commit ae5cec8

Browse files
authored
Add instructions for assigning and enabling the NetBird interface in pfSense (#411)
Signed-off-by: bcmmbaga <[email protected]>
1 parent d4b7cb3 commit ae5cec8

File tree

4 files changed

+38
-0
lines changed

4 files changed

+38
-0
lines changed
184 KB
Loading
93.6 KB
Loading
98 KB
Loading

src/pages/how-to/installation/pfsense.mdx

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,44 @@ Use this section for diagnostics and troubleshooting common connection or setup
6969
<img src="/docs-static/img/how-to-guides/pfSense/status.png" alt="connection status" className="imagewrapper-big"/>
7070
</p>
7171

72+
### Assign NetBird interface
73+
After authentication, a new interface named `wt0(wt0)` will be available but unassigned. To assign it go to
74+
`Interfaces` > `Assignments`. Under `Available network ports`, select the NetBird interface `wt0(wt0)` and click `Add`.
75+
76+
<p>
77+
<img src="/docs-static/img/how-to-guides/pfSense/new_interface.png" alt="NewInterface" className="imagewrapper-big"/>
78+
</p>
79+
80+
### Enable the NetBird interface
81+
82+
Now that the NetBird interface has been added, you need to enable it. Go to `Interfaces` > `OPT1`, then configure
83+
the following options and click `Save`, then `Apply changes` to activate the interface:
84+
85+
- **Enable**: `✓ Enable Interface`
86+
- **Description**: `NetBird`
87+
88+
<p> <img src="/docs-static/img/how-to-guides/pfSense/enable_interface.png" alt="enableInterface" className="imagewrapper-big"/> </p>
89+
90+
### Configure Firewall Rules for the NetBird interface
91+
92+
To allow NetBird to handle all access control, permit all traffic on the NetBird interface in pfSense. This ensures traffic
93+
flows freely, while NetBird’s own policies (ACLs) govern the access restrictions.
94+
95+
Create rules to control traffic coming from your NetBird network into pfSense and your local networks:
96+
97+
1. Go to `Firewall` > `Rules` and select the `NetBird` (interface) tab and click `Add` to create rules
98+
2. Configure the rule:
99+
- **Action**: `Pass`
100+
- **Interface**: `NETBIRD`
101+
- **Address Family**: `in`
102+
- **Protocol**: `Any`
103+
- **Source**: `Any`
104+
- **Destination**: `Any`
105+
- **Description**: `Allow all on NetBird (managed by NetBird)`
106+
3. Click `Save`, then `Apply Changes`
107+
108+
<p><img src="/docs-static/img/how-to-guides/pfSense/firewall_rules.png" alt="firewallRules" className="imagewrapper-big"/></p>
109+
72110
## Uninstallation
73111

74112
From a shell on your pfSense system, run:

0 commit comments

Comments
 (0)