Updating pfSense via Command Line: A Step-by-Step Guide

Published 20 January 2024 Last updated 20 January 2024 An older guide that hasn't been re-checked yet, so commands or versions may have moved on. How guides are made and checked

Ensuring your pfSense firewall is up-to-date is crucial for maintaining security and performance. While the graphical user interface (GUI) is the preferred method for most updates, sometimes issues arise, such as upgrading from version 2.7.0 to 2.7.1. This guide will walk you through updating pfSense via the command line to address specific errors and ensure a seamless upgrade.

About pfSense

pfSense is an open-source firewall and router platform based on FreeBSD. Additionally, pfSense is known for its robust security features and flexibility and is widely used to protect networks of various sizes.

Updating via the GUI

In typical scenarios, updating pfSense is straightforward through the GUI. Navigate to System > Update, select the desired version, and follow the prompts. However, the command line becomes a valuable alternative if you encounter issues via the GUI.

Why Updating May Be Needed via the Command Line

Certain situations, such as the mentioned errors during GUI updates, may necessitate a command line approach. Incompatibilities or glitches can occasionally prevent the GUI from accurately determining remote versions.

Note: When Upgrading from 2.7.0 to 2.7.1

If upgrading from version 2.7.0 to 2.7.1, you might encounter the following errors:

ERROR: It was not possible to determine pfSense remote version
ERROR: It was not possible to determine pfSense-base remote version
ERROR: It was not possible to determine pfSense-kernel-pfSense remote version
Your system is up to date

To address this, follow the troubleshooting steps provided by pfSense:
• Run “certctl rehash” to allow pkg to use system certificates until the next reboot.

Let’s Get Started

Step 1: Resolve GUI Upgrade Errors

If the GUI shows errors like the ones mentioned earlier, run the following commands:

certctl rehash
pfSense-upgrade -c

Step 2: Verify Available Version

After running the above commands, you should see:

2.7.1 version of pfSense is available

Step 3: Execute the Upgrade

Complete the upgrade by running:

pfSense-upgrade -d

Wrapping Up

Updating pfSense via the command line can be a straightforward solution when faced with GUI errors during version upgrades. By following these steps, you ensure your firewall remains secure and up to date. Always check pfSense documentation for the latest information and updates.

You May Also Be Interested In

For more information, visit the official pfSense troubleshooting guide.