sendnrw/netbird-docs
2
0
Fork 0
mirror of https://github.com/netbirdio/docs.git synced 2026-08-25 01:01:27 +02:00
Code Issues Packages Projects Releases Wiki Activity

Add an Updating section to the pfSense install guide (#866)

Browse Source 
* Add an Updating section to the pfSense install guide

Document upgrading in place: re-fetch the latest netbird and
pfSense-pkg-NetBird .pkg files from the latest GitHub release and re-run
pkg add -f on both (no pkg delete first, -f upgrades in place), then
netbird service restart and netbird status -d to verify. Matches the
Installation section's step style and the <RELEASE_TAG>/<VERSION>/<ARCH>
placeholders, and the Updating-before-Uninstallation layout used on the
Linux and Synology pages.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* Point the pfSense upgrade step at the downloaded filenames

Mirror the Installation step wording so the pkg add commands use the
exact filenames downloaded from the release, which have independent
NetBird and pfSense package versions.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Bruno Mercier Costa
2026-07-22 17:04:43 +02:00
committed by GitHub
parent e4b4eb737c
commit 0bbf69dad0
1 changed files with 27 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
src/pages/get-started/install/pfsense.mdx
View File

@@ -145,6 +145,33 @@ By default, pfSense uses automatic outbound NAT which randomizes source ports. T
- Run `netbird service restart` on the device.
- Run `netbird status -d` to verify the connection.
## Updating
To upgrade an existing install, fetch the latest packages and re-run `pkg add -f` over the current ones. There is no need to `pkg delete` first: the `-f` flag upgrades the packages in place.
1. **Download the latest packages**
From the [latest pfSense NetBird release](https://github.com/netbirdio/pfsense-netbird/releases/latest), fetch both `.pkg` files for your architecture, replacing the tag, version, and architecture values with those from the release page (as in [Installation](#installation)):
```sh
fetch https://github.com/netbirdio/pfsense-netbird/releases/download/<RELEASE_TAG>/netbird-<VERSION>-<ARCH>.pkg
fetch https://github.com/netbirdio/pfsense-netbird/releases/download/<RELEASE_TAG>/pfSense-pkg-NetBird-<VERSION>-<ARCH>.pkg
```
2. **Upgrade both packages in place**
Using the filenames you downloaded, run `pkg add -f` on both over the existing install:
```sh
pkg add -f netbird-<VERSION>-<ARCH>.pkg
pkg add -f pfSense-pkg-NetBird-<VERSION>-<ARCH>.pkg
```
3. **Restart and verify**
```sh
netbird service restart
netbird status -d
```
## Uninstallation
From a shell on your pfSense system, run: