The Handbook

    Theme
    • Guides
        • Check a system before installing FreeBSD
        • Orient a Linux administrator on FreeBSD
        • Supported FreeBSD releases
        • Choose a FreeBSD documentation and support channel
        • Move files safely without GNU mv -t
        • Update, upgrade, or update packages?
        • Upgrade 14.4 or 15.0 to FreeBSD 15.1
        • Choose packages, ports, or poudriere
        • Choose the quarterly or latest package branch
        • Choose a FreeBSD download or package mirror
        • Make a system setting persistent
        • Configure locale, keyboard, and time zone
        • Configure a serial console for recovery
        • Choose a custom kernel, module, or loader setting
        • Run a Linux binary with the compatibility layer
        • Check desktop and laptop hardware before installation
        • Choose and check a graphics driver
        • Choose Xorg or Wayland
        • Build a maintainable desktop baseline
        • Install and check a desktop browser
        • Check laptop Wi-Fi, power, and suspend
        • Check multimedia readiness
        • Choose and configure a printing stack
        • Run Windows applications with Wine
        • Snapshot and replicate a ZFS dataset
        • Choose a filesystem and storage layout
        • Operate ZFS without losing the recovery path
        • Restore files from a ZFS snapshot
        • Read ZFS pool health and run a scrub
        • Replace a failed device in a ZFS mirror
        • Replicate a ZFS dataset over SSH
        • Change PF safely on a remote host
        • Configure a narrow WireGuard tunnel
        • Plan a FreeBSD home server
        • Choose a mail server or an outgoing relay
        • Publish a network service safely
        • Choose a jail network model
        • Choose native jails or a jail manager
        • Choose a jail or a bhyve virtual machine
        • Establish a FreeBSD security baseline
        • Choose a MAC policy
        • Audit security-relevant activity
        • Start a DTrace performance investigation
    • Integrations
        • Create a first jail with Bastille
        • Compare jail managers and OCI tooling
        • Publish a Bastille service through PF
        • Mount a ZFS dataset in a Bastille jail
        • Update and upgrade Bastille jails
        • Back up and restore a Bastille jail
        • Prepare bhyve and vm-bhyve
        • Choose NFS or Samba for file sharing
        • Choose ZFS backup automation
        • Operate a signed poudriere repository
        • Manage FreeBSD configuration with Ansible or Salt
        • Run Motion with webcamd on FreeBSD
        • Design a reverse proxy, certificates, and monitoring
    • FAQ
    • Troubleshooting
        • Recover an interrupted freebsd-update run
        • Resolve a package repository or ABI mismatch
        • Diagnose the FreeBSD boot path
        • Recover with a ZFS boot environment
        • Diagnose DNS, routing, and firewall paths
        • Diagnose network mbuf exhaustion
        • Bind a service to a low port without running it as root
        • Diagnose audio output or input
        • Diagnose webcamd, cuse, and a webcam
        • Fix USB device permissions without opening every device
    • About this handbook
    • Synopsis
    • Understand the support model
    • Identify the installed state
    • Plan before the end date
    • Primary references

    Supported FreeBSD releases

    Last reviewed
    13 August 2026
    Applies to
    15.1-RELEASE, 15.0-RELEASE, 14.4-RELEASE

    Synopsis #

    A FreeBSD release stops receiving security advisories and errata notices after its support period ends. A system does not become unusable on that date, but newly discovered base-system problems may remain uncorrected. Package availability can also become difficult after a release leaves the supported set.

    The FreeBSD Security Officer currently lists these supported release branches:

    Release Release date Earliest expected end of support
    15.1-RELEASE June 16, 2026 March 31, 2027
    15.0-RELEASE December 2, 2025 September 30, 2026
    14.4-RELEASE March 10, 2026 December 31, 2026

    These dates are planning inputs, not values to copy permanently into monitoring code. The official support page states that an expected end date can be extended. Check that page again before every maintenance window.

    Understand the support model #

    Each minor release is supported until three months after the next minor release in the same major series. The final minor release remains supported until the corresponding stable branch reaches its end of support. From FreeBSD 15 onward, a stable branch is explicitly supported for four years from its .0 release. The FreeBSD 14 stable branch has an expected end date of November 30, 2028.

    Support for a stable branch does not keep every earlier X.Y-RELEASE supported. Security advisories name the affected and corrected release branches. A host on an end-of-life minor release should be upgraded rather than treated as covered by the continued existence of stable/X.

    -BETA and -RC builds are short-lived test releases and are not production alternatives to a supported -RELEASE.

    Identify the installed state #

    Record the running kernel, installed kernel, and installed userland:

    $ freebsd-version -kru
    

    A patch suffix such as -p4 identifies a security or errata patch level within the release. A difference between the running and installed kernel can be expected immediately after installing a kernel update and before rebooting. It should not be mistaken for a different supported release.

    Also identify how the base system is maintained:

    $ pkg which /usr/bin/uname
    

    If the file is not registered to a package, the host normally uses distribution sets and freebsd-update. A result such as FreeBSD-runtime-15.0 identifies pkgbase. The update, upgrade, or package-update guide explains the maintenance boundary.

    Plan before the end date #

    Schedule a supported upgrade while both the source and destination releases are still documented and package repositories remain available. The upgrade path is based on release chronology, not only the major number. Moving backward chronologically or skipping a major series is unsupported even when a tool accepts the target string.

    For the current production release, use the 15.1 upgrade checklist . Systems older than 14.4-RELEASE or 15.0-RELEASE must first move incrementally to a documented source release.

    Primary references #

    • FreeBSD Security Information: supported releases and support model
    • FreeBSD Handbook: versions, updates, and upgrade paths
    • freebsd-version(1)

    Independent documentation. Not affiliated with or endorsed by the FreeBSD Project or the FreeBSD Foundation.

    Report a bug
    • Synopsis
    • Understand the support model
    • Identify the installed state
    • Plan before the end date
    • Primary references