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:

      ReleaseRelease dateEarliest expected end of support
      15.1-RELEASEJune 16, 2026March 31, 2027
      15.0-RELEASEDecember 2, 2025September 30, 2026
      14.4-RELEASEMarch 10, 2026December 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