OPNsense images
===============

Welcome!  This document describes images types, SSL flavours and frequency
of image releases.  It is kept up to date.  You are reading the latest one.

Our release schedule
====================

We release images only when they are absolutely needed and otherwise stick
to our reliable firmware update process through either the GUI (System:
Settings: Firmware) or the root console (Option 12).

This does not always work, so there may be revoked images and images built
on stable updates, e.g. 18.1.6 as opposed to only 18.1.

The latest stable release image for OPNsense is 23.7 (July 31, 2023).

The next scheduled release image for OPNsense is 24.1 (January, 2024).

It is advised to update to the latest version immediately after installation.

Available image types
=====================

o dvd: ISO installer UEFI hybrid image with live system capabilities
  running in VGA mode.
o vga: USB installer UEFI hybrid image with live system capabilities
  running in VGA mode.
o serial: USB installer UEFI hybrid image with live system capabilities
  running in serial console (115200) mode.
o nano: A preinstalled serial image for USB sticks, SD/CF cards, SSD
  with secondary VGA console enabled.  These images are 3G in size and
  automatically adapt to the installed media size after first boot.

Checksum verification
=====================

Checksum files next to the images may not prove authenticity of images
on any particular mirror.  The checksums can also be found in the forum
annoucements, GitHub or blog posts.  Please double-check.

https://github.com/opnsense/changelog/tree/master/community
https://forum.opnsense.org/index.php?board=11.0
https://opnsense.org/blog/

Signature verification
======================

All images also have OpenSSL SHA-256 signatures, which can be verified
against the distributed public key.  For instructions please visit:

https://docs.opnsense.org/manual/install.html

The public key for version 23.7 is:

-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAu90d9OlhEEqfPTRC5tVp
XK1KAtvzKPVf2jvmTtWgFRFCB3fuYQcO7oNefXJoK0LaHNQgiOsBTvepVMicl2aI
zrehgdbljjNFmp6KzEM55x05zOfZV8Gi8AEaJzEbb3rkWLkiXHnANfhHGvtHOrGr
Hct84NMCcfCZZerwaQMqi+SAjgUzA+asmhAvjN0fbdH2SLx/ZMNzDcyPRFGtGiC7
RQCzgCGz39ppJP4qordzRSy5YiwCxNe/SL/4ZG04eMVti47BPTCtioBzuASHqALJ
BVOFzZpr1WZ89PT/T5W6xYzoyWemOyv9Rh+rhaTAhnq+OO4yudaytpPCAtXBULr/
VOlDOX//qaZR8qbQOC9y9kIETH8Iivis5tonBAQmYPIJiqcxfjM4/R7yP2Q7mEsr
PLNyP6HNe77JGoW1axNZlB/OL1XUI3r+Kksc2woIqTQ5sq95tHbddNqGIDg4cEOX
FM5Y7tdvVEwl/nutaAzP07sqEyF8uNScLGsQwpBxHwV/qGGc+PbGqmbmWg3+Kt+e
UeNcMvrgayhRt+lpVCAorVVjUTp0Y2+1x+V/IpukOaS2oldPIF0iXLZsQ90KYP3X
QtmuxbiC2Em+eGHB6nSg1UZgUEaAb3xP1fpuLbi9McoUPxMXxVdfihSfSfUFXJTH
SmqdO1BdG7VSwiQq9Ekbu5UCAwEAAQ==
-----END PUBLIC KEY-----

More help needed?
=================

Find our source code and issue trackers: https://github.com/opnsense

Browse the docs: https://docs.opnsense.org/

Visit the forum: https://forum.opnsense.org/

Discuss on Reddit: https://www.reddit.com/r/OPNsense

Or drop us a tweet: https://twitter.com/opnsense https://bsky.app/profile/opnsense.bsky.social


Stay safe,
Your OPNsense team