OPNsenseLab
Getting Started

OPNsense Initial Setup: Complete Installation Guide (2026)

Step-by-step walkthrough for installing OPNsense on a Protectli vault or mini-PC, covering installer options, interface assignment, WAN/LAN configuration, and first-boot hardening.

By OPNsenseLab Editorial · · 8 min read

OPNsense is an open-source firewall and routing platform based on FreeBSD. This guide walks you through a fresh install from USB to a working WAN+LAN configuration.

Hardware: What you need

Any x86-64 system with at least two NICs works. Common homelab choices:

For a basic WAN+LAN setup any two-NIC x86-64 box is sufficient, including a repurposed Optiplex or ThinkCentre.

Download the installer

  1. Go to opnsense.org/download and grab the latest stable release.
  2. Choose dvd for a live/install image or nano for embedded (CF/SSD with limited writes).
  3. Write to USB: dd if=OPNsense-*.iso of=/dev/sdX bs=4M status=progress (Linux/macOS).

Boot and install

  1. Boot from USB. Default login at the live console: installer / opnsense.
  2. Select Guided installation → accept disk layout → set root password.
  3. Reboot, remove USB.

Interface assignment

At the console prompt (option 1 — Assign interfaces):

Do you want to configure LAGGs now? → N
Do you want to configure VLANs now? → N
Enter the WAN interface name: igb0    (your WAN NIC)
Enter the LAN interface name: igb1    (your LAN NIC)

Confirm and let it apply.

First-boot web UI access

From a LAN-connected device, browse to https://192.168.1.1. Default credentials: root / opnsense.

Run the setup wizard (System → Wizard) to:

Immediate hardening steps

Before doing anything else:

  1. Change root password — System → Settings → Administration → Password
  2. Disable HTTP access — same page, uncheck “HTTP redirect”
  3. Enable auto-update check — System → Firmware → Settings → enable “Release type: Production”
  4. Lock SSH to key-auth only — if you enable SSH, disable password auth immediately

Next steps

Comparing platforms? See firewallcompare.com for OPNsense vs pfSense vs UniFi side-by-side.

#opnsense #installation #setup #beginner #protectli

Related

Comments