In pfSense software, the serial number is typically a hardware-derived identifier used for support and registration purposes. Its location and retrieval method depend on whether you are using official Netgate hardware or your own generic system. Where to Find the Serial Number Main Dashboard : The serial number is displayed in the System Information widget on the main status dashboard. Netgate Hardware : Displays the official manufacturing serial number. Generic/White Box : Often displays a System UUID Netgate Device ID (NDI)
instead, as generic hardware BIOS entries may be unpopulated. Physical Sticker
: On official Netgate appliances, the serial number is usually printed on a sticker on the bottom or back of the device. Console/SSH Banner Netgate Device ID (NDI)
, which serves a similar unique identification purpose, is shown in the banner when you log in via SSH or a serial console. Netgate Forum Retrieving it via Command Line
If the serial number does not appear in the WebGUI, you can attempt to pull it directly from the hardware's DMI (Desktop Management Interface) data using the shell:
: This is the most reliable tool for pulling BIOS/hardware info. Install it (if not present): pkg install dmidecode /usr/local/sbin/dmidecode -t 1 | grep "Serial Number" : You can also check the kernel environment variables: kenv | grep smbios.system.serial Netgate Forum Serial Number vs. Netgate Device ID (NDI)
While often used interchangeably, they serve different functions: Serial Number pfsense serial number
: Tied to the physical hardware unit. Useful for hardware warranty and Netgate TAC support Netgate Device ID (NDI) : A unique, hashed ID (SHA256) used specifically to tie pfSense Plus software subscriptions or registration tokens to a specific installation. Common Issues System serial number | Netgate Forum
The pfSense serial number is a unique identifier primarily used to identify hardware appliances for support, warranty, and software registration. While it is most critical for official Netgate hardware, even custom builds may display a serial number or a host UUID depending on the system's BIOS. Where to Find Your pfSense Serial Number
There are three primary ways to locate your serial number: through the web-based interface, the command-line interface (CLI), or the physical hardware itself. 1. The WebGUI Dashboard
The easiest way to find the serial number is through the pfSense WebGUI dashboard .
System Information Widget: On the main dashboard, look for the System Information widget.
Field: If you are using official Netgate hardware, the Serial Number will be clearly listed here. In pfSense software, the serial number is typically
UUID Alternative: For generic hardware where a serial number isn't populated in the BIOS, pfSense will display a Host UUID instead. 2. Command Line Interface (CLI)
If you are connected via SSH or a console cable, you can pull the serial number directly from the system environment using these commands:
Standard Command: Run dmidecode -t system | grep Serial to pull the serial number directly from the hardware BIOS.
Netgate Specific: You can also try running kenv to see various kernel environment variables that often include hardware identifiers.
Diagnostic Tool: In the WebGUI, navigate to Diagnostics > Command Prompt and execute the dmidecode command if you don't have SSH enabled. 3. Physical Hardware Label
For official Netgate appliances (such as the SG-2100 or XG-1541), the serial number is printed on a physical sticker. System serial number | Netgate Forum Best Practice for VM Serial Numbers: To avoid
Here’s a helpful overview and reference “paper” (structured guide) regarding pfSense serial numbers — what they are, where to find them, how they’re used, and why they matter.
To avoid clone conflicts, manually assign a unique UUID in your VM config:
serial0: socket and set smbios1: uuid=...serialNumber = "YourUniqueVM-SN01"This allows you to track hundreds of virtual pfSense instances via asset management tools.
Before diving into the "how-to," it's critical to understand the why. The serial number in pfSense is not just an inventory tag. It serves three primary functions:
This is where the keyword "pfsense serial number" becomes a support nightmare. Let’s fix common scenarios.
| Method | Steps |
|--------|-------|
| WebGUI | System > General Setup → Look for “Serial Number” field (read‑only) |
| Dashboard | System > Dashboard → System Information widget shows “Serial Number” |
| Console / SSH | Run pfSense-upgrade -d or cat /etc/version (some versions) |
| Shell command (Unix) | sqlite3 /conf/config.xml "SELECT value FROM system WHERE attribute='serial';" |
| Backup file | Inspect /conf/config.xml – search for <serial> tag |