From c4af3f13a4e9932968d92872aaf22312a6e79e4e Mon Sep 17 00:00:00 2001
From: Alexander Ziaee <ziaee@FreeBSD.org>
Date: Wed, 6 May 2026 17:23:52 -0400
Subject: [PATCH] freebsd-base.7: Document adding a local repo

MFC after:		1 day
Discussed with:		bcr, ivy, kevans, ngie
Differential Revision:	https://reviews.freebsd.org/D56608
---
 share/man/man7/freebsd-base.7 | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/share/man/man7/freebsd-base.7 b/share/man/man7/freebsd-base.7
index 51de679ea9d..d1857b2dbbe 100644
--- a/share/man/man7/freebsd-base.7
+++ b/share/man/man7/freebsd-base.7
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd April 14, 2026
+.Dd April 23, 2026
 .Dt FREEBSD-BASE 7
 .Os
 .Sh NAME
@@ -217,6 +217,27 @@ for a different target than the host system):
 pkg -r /ppcdev -oABI=FreeBSD:16:powerpc64le \e
     install FreeBSD-set-devel
 .Ed
+.Ss Adding a locally built repository for snapshots
+Disable the predefined repository,
+and add a local repo for locally built base system packages:
+.Bd -literal -offset indent
+cat << EOF > /usr/local/etc/pkg/repos/FreeBSD.conf
+FreeBSD-base: { enabled: no }
+FreeBSD-local: {
+	url: "file:///usr/obj/usr/src/repo/${ABI}/latest",
+	enabled: yes
+}
+EOF
+.Ed
+.Pp
+The packages are created by the
+.Xr build 7
+system at
+.Pa ${REPODIR}/${PKG_ABI}/<VERSION> ,
+which defaults to the example directory.
+.Pp
+.Sy Note :
+The repo must have a different name than the predefined repository.
 .Ss Unregister a currently running system
 Systems managed through
 .Xr pkg 8