In pfSense, a "serial number" typically refers to the physical hardware's identification rather than a software license key. How you find it depends on whether you are using official Netgate hardware or a custom "white box" build. 1. Finding the Serial Number via WebGUI
If your hardware supports it (like official Netgate appliances), the serial number is usually displayed directly on the Dashboard in the System Information widget. Netgate Hardware: Displays as "Netgate Serial: [Number]".
Custom Hardware: If the motherboard supports standard SMBIOS reporting, pfSense may pull the serial number from there. If no serial number is found, it often displays a unique System UUID or the Device ID instead. 2. Finding the Serial Number via Command Line (CLI)
You can retrieve hardware serial information through the Shell (Option 8 in the console menu) using these commands: Primary Command: /bin/kenv smbios.system.serial.
Netgate Specific: On newer pfSense Plus versions, use sysctl dev.netgate to see detailed hardware nodes.
Alternative Tool: If the above fails, you can install and use dmidecode to pull more detailed BIOS/hardware info: pkg install dmidecode dmidecode -s system-serial-number Use code with caution. Copied to clipboard
(Note: dmidecode may not be installed by default on all versions). 3. Physical & Third-Party Hardware System serial number | Netgate Forum
In the pfSense ecosystem, "serial number" can refer to physical hardware identification, software-linked identifiers for support, or even cryptographic certificate metadata. 1. Hardware Identification
For official Netgate hardware, the serial number is a unique physical identifier used to track warranties and support eligibility.
Location in WebGUI: Often displayed in a dashboard widget if the hardware is recognized. If the hardware is a generic "white box" or a custom build, the system may show a Host UUID instead.
Command Line Retrieval: You can attempt to find the serial number using the dmidecode or kenv commands via the Diagnostics > Command Prompt or an SSH/console session. 2. Software & Support (Netgate ID/Serial)
In recent versions, such as pfSense Plus, the serial number (or Netgate ID) is essential for software lifecycle management.
Netgate ID: This unique string is used to identify your specific instance for the purpose of pfSense Plus firmware requests and software updates.
Support Tickets: Netgate support staff use this identifier to verify your device's original order, warranty status, and whether support services are active for that specific unit. 3. Serial Console Access
"Serial" also refers to the Serial Console Port used for emergency management and initial configuration. Show serial number in webgui? - Netgate Forum
What is a pfSense Serial Number?
pfSense is a popular open-source firewall and routing software that is widely used to secure networks and protect against cyber threats. When installing or configuring pfSense, you may come across the term "serial number" which can be confusing for some users.
Why does pfSense have a Serial Number?
The pfSense serial number is a unique identifier assigned to a pfSense installation. It is used for various purposes, including:
Where to Find the pfSense Serial Number?
You can find the pfSense serial number in the following locations:
/etc/pfSense/ config.xml.How to Get a pfSense Serial Number?
If you don't have a pfSense serial number, you can obtain one in the following ways:
Keep in mind that a pfSense serial number is only required for certain features and support services. If you're using pfSense for personal or evaluation purposes, you might not need a serial number at all.
Finding the serial number of your pfSense device is essential for support, registration, and hardware identification. Depending on whether you are using official Netgate hardware or a custom build, the methods for locating it vary. 1. Through the Web GUI (Easiest)
The quickest way to find the serial number for Netgate hardware is directly from the pfSense dashboard. Log in to your pfSense Web GUI. Navigate to Status > System Information.
Look for the Netgate Device ID or Serial Number field. On official appliances, the unique hardware serial number is usually displayed here. 2. Using the Command Line (CLI)
If you are connected via SSH or using the console port, you can pull hardware information directly from the BIOS or system management interface.
For Netgate Hardware: Run the following command to retrieve the serial number from the system's SMBIOS:dmidecode -s system-serial-number
For Custom Hardware: If dmidecode is installed, it may show the motherboard serial number, though this is not a "pfSense serial" in the same way Netgate's ID is. 3. Physical Label
Official Netgate appliances (like the SG-1100, 2100, 4100, etc.) have a physical sticker on the chassis. Check the bottom or back of the device. pfsense serial number
The label will typically list the Serial Number (S/N) and often the MAC Address. 4. Netgate Device ID vs. Serial Number It is important to distinguish between these two:
Serial Number: The physical hardware ID assigned during manufacturing. This is what you need for warranty claims.
Netgate Device ID: A unique string generated based on your hardware's characteristics. This is often used for pfSense Plus subscriptions and software registration. You can find this at the top of the Dashboard or under System > Register. Why do you need it?
Support Tickets: Netgate requires the serial number to verify your support eligibility.
pfSense Plus Upgrades: When moving from CE (Community Edition) to Plus, the software binds to your unique Device ID.
Inventory Management: Essential for tracking hardware in data centers or multi-site deployments.
You can find the serial number for a pfSense device—particularly official Netgate hardware—using several methods through the interface, command line, or physical hardware. 1. pfSense WebGUI (Dashboard) The most direct way is via the browser: System Information Widget : On the main dashboard, look for the System Information For official Netgate hardware, the field will explicitly display your unit's serial number.
For generic "white box" hardware, this field may display the System UUID or "Not Set" if not properly populated in the BIOS. Netgate Forum 2. Command Line (CLI / SSH)
If you are logged in via SSH or the console (Option 8 for Shell), use these commands: dmidecode -t system | grep Serial
to pull the serial number directly from the hardware's SMBIOS. /bin/kenv -q uboot.boardsn
to retrieve the board serial number specifically on some Netgate models. Banner info
: On many Netgate devices, the serial number is printed at the very top of the SSH/Console welcome banner. Netgate Forum 3. Physical Hardware : Most official Netgate appliances have a sticker on the of the device containing the serial number.
: The serial number is also typically listed on the original packaging box Netgate Documentation Important Distinction: Serial Number vs. NDI
How to find product Serial Number and Check Number | Official Support 02-Feb-2026 —
pfSense serial number is a unique identifier primarily used to verify hardware authenticity and manage Netgate Service and Support . Depending on whether you are using official Netgate appliances In pfSense, a "serial number" typically refers to
or custom "white box" hardware, the system will display either a physical manufacturer serial or a software-generated ID. Netgate Documentation Where to Find the Serial Number WebGUI Dashboard : Navigate to the main status page. In the System Information
widget, the serial number is listed under the "System" section alongside the model and Netgate Device ID (NDI). Console/SSH : Log in to the console or an SSH session. The Console Menu banner often displays the serial number at the top. Physical Label : For official hardware from retailers like
, the serial number is typically printed on a label on the bottom or back of the unit. Netgate Forum Retrieving via Shell Commands
If the information is not appearing in the GUI, you can pull hardware identifiers directly from the pfSense shell (Option 8 in the console menu): Netgate Documentation Standard BIOS Serial utility to pull manufacturer data: dmidecode -s system-serial-number Alternative Method is not installed, you can try: kenv smbios.system.serial Generic Hardware : On non-Netgate systems, pfSense may instead display the kern.hostuuid , which is a randomly generated UUID created during the first boot after installation. Netgate Forum Key Differences: Serial Number vs. Netgate Device ID (NDI) Serial Number
: Tied to the physical hardware or BIOS. It is used for warranty claims and original order verification Netgate Device ID (NDI) : A unique software-calculated string used to link support contracts
to a specific instance of pfSense, preventing "spoofing" on generic hardware. Sensitive Information & Security System serial number | Netgate Forum
In pfSense, a key feature of the system serial number is its role in Netgate hardware identification, allowing the Netgate Support Team to quickly verify a device's order history, warranty status, and eligible support levels.
Other notable features related to serial numbers in pfSense include:
Dashboard Visibility: The serial number is prominently displayed in the System Information widget on the main dashboard for official Netgate hardware.
Automatic Registration: For hardware purchased from Netgate, the serial number is often used to automatically register pfSense Plus software.
Generic Fallback: On non-Netgate (generic) hardware, pfSense typically displays a randomly generated UUID (kern.hostuuid) in place of a hardware serial number to maintain a unique system identifier.
Certificate Revocation: In the Certificate Manager, you can revoke specific certificates by manually entering their unique certificate serial number.
Troubleshooting Access: During a "lockout" or network failure, the serial console port provides an out-of-band "emergency lifeline" to fix configuration issues without needing network access. System serial number | Netgate Forum
The location of the serial number varies drastically depending on your setup. Below are the four definitive ways to find it.
If you own a legitimate Netgate appliance (the official hardware for pfSense), the serial number is required for support, warranty, and software updates. Licensing : Some pfSense features, such as support
| Issue | Likely Cause | Solution |
|-------|--------------|----------|
| Serial number missing in WebGUI | Old config from pre‑2.3 version | Run config.xml upgrade via CLI |
| Duplicate serial numbers | Cloned VM or disk image | Regenerate on each instance (CE only) |
| ACB fails with “invalid serial” | Netgate Plus on non‑Netgate HW | This is unsupported; use CE instead |
| Serial changes after reboot | Corrupt /conf/config.xml or R/W failure | Restore from backup, check filesystem |
Register Here to Get Our Latest Content and Special Subscriber-Only Offers!