Reinstalling pfSense Plus Software

This guide uses the Netgate Installer to install pfSense® Plus software on a Netgate-1100 device.

Note

pfSense® Plus is preinstalled on Netgate appliances. It is optimally tuned for Netgate hardware and contains features that cannot be found elsewhere, such as ZFS Boot Environments, OpenVPN DCO, Built-in IPFIX Export, and the AWS VPC Wizard.

Download Installation Media

The Netgate Installer can be downloaded from the Netgate Store using a Netgate Store Account.

See also

For a more detailed walkthrough of the download process, see Download Installation Media in the pfSense Software Documentation.

The image to download for this device is:

netgate-installer-aarch64.img.gz

Prepare Installation Media

Next, write the installation image to a USB memstick.

See also

Locating the image and writing it to a USB memstick is covered in detail under Writing Flash Drives.

Connect to the Console

The installation process is interactive and utilizes the console. Follow the directions under Connect to the console to configure and use the console.

Boot the Installation Media

  1. Insert the memstick into the USB port and boot the system.

    Tip

    The best practice is to connect to the console, turn off the device gracefully by using the Halt system option from the console and removing power once the shutdown procedure completes, then insert the USB memstick and boot the device.

    Starting the recovery process requires interrupting the boot process very soon after the boot process begins, so having an active console connection before booting is important.

  2. When prompted, press any key to stop the autoboot process.

    ../_images/1100-reinstall-01-autoboot.png

  3. Type run usbboot at the Marvell>> prompt and press Enter.

    Note

    If the device does not boot after issuing this command, enter usb reset and then try run usbboot again. Some USB drives require an extra reset to fully initialize.

    If the device still does not boot the installer, or the installer fails, use run usbrecovery instead which will wipe the drive before starting the installer.

Determine Target Drive

During the installation process the installer will prompt to select a target drive. The installer will then write pfSense® Plus to the chosen drive. In most cases a device will have only one potential target drive.

  • On devices with only MMC storage, the only choice is mmcsd0.

  • USB storage devices appear as daX where X is a device number, such as da1. The device number may shift depending on the order in which the OS probes USB devices or the order in which they are inserted while the OS is running.

    Note

    The installation media is also a USB drive, but the installer does not offer its own disk as a target drive.

Install pfSense Plus Software

The installer will automatically launch and present several options. On Netgate appliances, choosing Enter for the default options will complete the installation process in most cases.

Tip

There are options on the Welcome screen of the installer which can recover configuration data from a previous installation or from a USB drive.

See also

For a complete walkthrough of the installation process, see Installation Walkthrough.

When the installation is complete, remove the USB drive from the USB port.

Important

If the USB drive remains attached, the device may boot into the installer again.

See also

For information on restoring from a previously saved configuration, go to Backup and Restore.