The pfSense serial number is a vital piece of information for any pfSense installation. It aids in identification, troubleshooting, and ensuring compliance with licensing terms. By understanding its significance and knowing how to find and manage it, you can better maintain and support your pfSense installations. Whether you're a network administrator, a security professional, or a DIY enthusiast, keeping track of your pfSense serial numbers is an essential part of managing your network infrastructure.
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 pfsense serial number
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
: 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 vital piece
A "full guide" for pfSense serial numbers covers several different topics depending on what you are trying to achieve. Are you trying to find the serial number of your hardware? Are you trying to change the serial number in the configuration (common with China-imported network cards)? Or are you looking to validate a Netgate appliance license?
Here is the comprehensive guide covering all aspects of pfSense Serial Numbers.
This is the most common reason people search for this guide.
The Context: Many users buy 10Gb network cards (often Chelsio or Intel clones) from online marketplaces (AliExpress, eBay). These cards often have the serial number 00:00:00:00:00:00 or a duplicated serial number. pfSense Plus (the official version) requires a unique, valid serial number to run on standard hardware (non-Netgate hardware). This is the most common reason people search for this guide
The Fix: You must flash a new serial number into the card's EEPROM.
Prerequisites:
Understanding and knowing the serial number of your pfSense installation is crucial for several reasons:
| 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 |