README.md
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.7 (July 23, 2025).

The next scheduled release image for OPNsense is 26.1 (January, 2026).

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

-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAn9lXekbm5KcktbiWpmQf
drRC8LmAOTV9Cbdd3em6iDFFcw8vmRS7Rbo2/exxYiPCqEPxxPtUsW+g/a6fqPJp
pof5D1EHWqzPfkjRQV6ipQjm+ocJGkfbeHsp5I77L+w7om5TbPYBkOjg+iMd442d
VYxgqXmMZy+6v78ofVM+wyba0GkRymFt0qf5k5uk3Auztcfanc2Ymsc+PDdjGHQd
c9H8T0T6To8Z0xrbEXzY00IqSRkLto9Cl+xEmEAz/AiEu2WtEadOqSpDy9dsJfQg
HpBQVlGQdphj5zmkqG6JSL1Uw+02OeIXOfFWRtqgW7vMyU0IbER3hLpvh6BlsqNJ
LCPfD7F/dzDPU5LniDRRb4MrTlVpJk2h8pk7GbmJCqAyWJJZ6n3a+InPtUfl9gP5
T0d15N7myh8RLssP+TIy8hiBHtc/yK89dUahGei1xDuh0HdytRLLLWVXqgWwgXhd
9it8l8AJ/D2BtuyExpJOWx3sYvmhJiPN8phCaR2G2E+QRA2X5nHGyUw5jYpKI8Om
Q2khz1PBYcA/T5lKhM3HRFCu2HZsPKT5CEevZfUuPDXIqwx+LMFs6qqbzbGrdn1F
H6ZSlG0BWuokeyjhN2mB0Fr6kdLobmfVgZHUS7KOwcI9BdftSDbEk8kMxrQlwugh
4I1hTrAycMERbjeUKg1plx8CAwEAAQ==
-----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