From c2b197a211d5e80d2647fc86b501ef8f1806cc0c Mon Sep 17 00:00:00 2001 From: Dave Cottlehuber Date: Mon, 1 Dec 2025 22:37:50 +0000 Subject: [PATCH] releases/15.0R/relnotes: document how to fetch new signing keys for BETA/RC users Reviewed by: cperciva, zaiee Approved by: zaiee Sponsored by: SkunkWerks, GmbH --- .../content/en/releases/15.0R/relnotes.adoc | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/website/content/en/releases/15.0R/relnotes.adoc b/website/content/en/releases/15.0R/relnotes.adoc index ff73972a40..622aaee6ae 100644 --- a/website/content/en/releases/15.0R/relnotes.adoc +++ b/website/content/en/releases/15.0R/relnotes.adoc @@ -65,6 +65,40 @@ Source-based upgrades (those based on recompiling the FreeBSD base system from s Upgrading FreeBSD should only be attempted after backing up _all_ data and configuration files. ==== +[[upgrade-rc]] +== Upgrading from Existing Pre-Release Base System Package Installs +[IMPORTANT] +==== +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-upgrade[8] utility. +==== + +Users should either manually copy the required files from a source tree checkout of `15.0-RELEASE` tag, or a later commit in `STABLE` or `CURRENT` branches, or alternatively, force-install the `FreeBSD-pkg-bootstrap` package from the official release base system packages. + +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. + +.... +# cp /usr/src/usr.sbin/pkg/FreeBSD.conf.quarterly-release \ + /etc/pkg/FreeBSD.conf +# cp -R /usr/src/share/keys/pkgbase-15 /usr/share/keys/pkgbase-15 +.... + +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. + +.... +# pkg add -f https://pkg.freebsd.org/FreeBSD:15:(uname -p)/base_release_0/FreeBSD-pkg-bootstrap-15.0.pkg +# sha256 -r /etc/pkg/FreeBSD.conf /usr/share/keys/pkg/trusted/pkg.freebsd.org.2013102301 \ + /usr/share/keys/pkgbase-15/trusted/awskms-15 /usr/share/keys/pkgbase-15/trusted/backup-signing-15 +ab261a3b84ffc11654ac0bafbb7d6b3f1b6afc30bfabab3bcff64259678eac26 /etc/pkg/FreeBSD.conf +036ae4f9c441a3febb41734bbb37227ec3374edd3c6c687e5cb70d580efbea30 /usr/share/keys/pkg/trusted/pkg.freebsd.org.2013102301 +529c79e85a6ca152faa9d57ead85fe0111ffada8d0a0fa2f11fc510999fa50df /usr/share/keys/pkgbase-15/trusted/awskms-15 +c368ec8d05654bdaad34742c1d75b9b150bfc3892838cef32f6e5b036b0c0605 /usr/share/keys/pkgbase-15/trusted/backup-signing-15 +.... + +[IMPORTANT] +==== +Upgrading FreeBSD should only be attempted after backing up _all_ data and configuration files. +==== + [[security-errata]] == Included Security Fixes and Errata Patches