From 0bbf69dad03f4fae286562c5c9fe48534f89619b Mon Sep 17 00:00:00 2001 From: Bruno Mercier Costa <94469565+emrcbrn@users.noreply.github.com> Date: Wed, 22 Jul 2026 17:04:43 +0200 Subject: [PATCH] Add an Updating section to the pfSense install guide (#866) * 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 // placeholders, and the Updating-before-Uninstallation layout used on the Linux and Synology pages. Co-Authored-By: Claude Opus 4.8 * 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 --------- Co-authored-by: Claude Opus 4.8 --- src/pages/get-started/install/pfsense.mdx | 27 +++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/src/pages/get-started/install/pfsense.mdx b/src/pages/get-started/install/pfsense.mdx index c01793e6..007cd403 100644 --- a/src/pages/get-started/install/pfsense.mdx +++ b/src/pages/get-started/install/pfsense.mdx @@ -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//netbird--.pkg + fetch https://github.com/netbirdio/pfsense-netbird/releases/download//pfSense-pkg-NetBird--.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--.pkg + pkg add -f pfSense-pkg-NetBird--.pkg + ``` + +3. **Restart and verify** + + ```sh + netbird service restart + netbird status -d + ``` + ## Uninstallation From a shell on your pfSense system, run: