-For users of PRERELEASE, ALPHA, and BETA builds of FreeBSD 15.0, due to late-breaking changes in FreeBSD.org infrastructure, it is not possible to upgrade directly using the man:pkg[8] utility.
+Upgrading previous system versions to {localrel} is not yet supported!
+Back up _all_ filesystems!
====
-Packaged base system installations require either manually copying the required files from a source tree checkout of the `15.0-RELEASE` tag, or alternatively, force-install the `FreeBSD-pkg-bootstrap` package from the official release base system packages.
+Packaged system installations currently require either manually copying configuration from the target source, or re-initializing the package manager using the target repository.
-The recommended, and most secure approach, is using the source tree checkout of any of head, stable/15, or releng/15.0 branches after 2025-11-27 22:00 UTC.
+The recommended, and most secure approach, is to copy the files from the `releng/15.0` source branch after 2025-11-27 22:00 UTC:
-Users who do not have up to date sources installed may use a less secure, but simpler approach, validating the checksums after installation. As these are architecture-independent files, the checksums will match on all platforms. The FreeBSD-base package repository will need to be enabled before upgrading via man:pkg[8]:
+For the alternative approach, force install the `FreeBSD-pkg-bootstrap` package.
+After installation, validate the architecture-independent checksums, which will match on all platforms.
+After the repository has been configured using either of these methods, upgrade the system software with the static package manager, specifying the target system version `15`, and the target filesystem mounted at `/mnt/upgrade`: