OPNsense 21.7 "Noble Nightingale" has reached its end
of life. As such it will not receive any more updates, but the upgrade to the
new 22.1 series is seamless and can be performed right here from the
web GUI.
Another method is to import and reinstall using a new installation image,
which will retain your settings using "Import Configuration", then reformat
the disk and apply a clean system using either "Install (UFS)" or "Install
(ZFS)".
You can also upgrade via console / SSH by using option 12 from the menu by
typing "%%UPGRADE_RELEASE%%" when prompted.
Make sure to read the migration notes and adjust for possible breaking changes:
- This release contains a new major operating system version and should be carried
out with the necessary care. Despite extended test coverage changes made by FreeBSD may
still affect operation without our knowledge. Except for ZFS boot environments rollbacks
between major operating system versions are extremely fragile and a reinstall of an older
version should be attempted in the worst case.
- IPsec hash and cipher removals in FreeBSD 13 can affect existing setups as insecure
cryptographic options have been removed upstream. If you are using MD5, Blowfish, DES, 3DES
or CAST128 in your phase 2 please move to more secure settings prior to the upgrade.
- The Realtek vendor driver is no longer bundled with the updated FreeBSD kernel. If unsure
whether FreeBSD 13 supports your Realtek NIC please install the os-realtek-re plugin prior to
upgrading to retain operability of your NICs.
Please backup your configuration, preview the new version via live image or
in a virtual machine. Create snapshots. If all else fails, report back
in the forums for
assistance.