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

Welcome! This document describes images types 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 25.1 (January 29, 2025).

The next scheduled release image for OPNsense is 25.7 (July, 2025).

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 25.1 is:

-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAsnbyFjWXvUcUC4BqnQ9w
uH3yiaG7AY8UzwepXf2TqqOYt5Y0USbse3OBjxYnRs0iW5EHtdKSRcmelup374Hp
XDDeQ/mjmhhnvXryfQL57gyVpYeL5gRVhf/2DwEZELLCFUFhMNh52QPaJ5zTvdws
m1Q+OwI1WfTDR7ytm+0Too2tVerG3mM3XataZ+XOKwHp2xP0Mr8E4F+PZdR4hWbb
yC2elIzICXDWWpcEEg4JT48TIYZJPGnE2IJAzWRntrqVU2eLcEn5MffwTawXNoCZ
mvLYqguYskmeR/dAL7ZmZcPeMeibXMtld8xIZp49g7DPq7PqxCY1wxcgeuZPFOHv
kbYzL3BHbyni3K/qdLXKzy8oZeUUvlbUgaj8Xx14DSiNzJDknNf0Xg/eby7MkzgP
eUXgtB0MRQMih85BfaiH5r+uQMgPKnjutVWR8qUWglxDKIc4s69b8PXylfu2FwiP
iKMBdO8xnVvNFKOkuaUtI31cqxauw2hBAlILFvltM+adUz2rfB3Ch0bjfjDE5Hxq
En4fEUVHgQCu+Ojyyy3/8RwUpsRZq05fObypyeL3E/MvlwpaOVjwvw2ozVPGi2zi
xmXemn5CbgjD3vPR9XERXrFkHTwPnIiqz53znqn34P+NGEgD1veMhZPE6OGZRu/h
IfceSaxJ/An5SUh0zr7YgOsCAwEAAQ==
-----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 message: https://bsky.app/profile/opnsense.bsky.social


Stay safe,
Your OPNsense team