Page MenuHomeFreeBSD
Files F146499899

D55458.diff
No OneTemporary
Actions

D55458.diff
View Options

diff --git a/share/man/man7/freebsd-base.7 b/share/man/man7/freebsd-base.7
--- 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 February 26, 2026
+.Dd February 27, 2026
.Dt FREEBSD-BASE 7
.Os
.Sh NAME
@@ -217,6 +217,63 @@
pkg -r /ppcdev -oABI=FreeBSD:16:powerpc64le \e
install FreeBSD-set-devel
.Ed
+.Ss Enroll a currently running system
+.Sy Warning :
+The following is a preview feature under development!
+.Pp
+Up-to-date systems installed through other means can be enrolled in
+.Xr pkg 8
+management.
+Once fully up-to-date, enable the FreeBSD-base package repository:
+.Bd -literal -offset indent
+cd /usr/local/etc/pkg/repos/
+echo "FreeBSD-base: { enabled: yes }" > FreeBSD.conf
+.Ed
+.Pp
+Refresh the database of available packages:
+.Bd -literal -offset indent
+pkg update -f
+.Ed
+.Pp
+Register the existing base system with
+.Xr pkg 8 :
+.Bd -literal -offset indent
+pkg install --register-only FreeBSD-set-base
+.Ed
+.Pp
+Base system components can now be managed through
+.Xr pkg 8 .
+.Pp
+.Sy Warning :
+This will prevent updating the system with
+.Xr freebsd-update 8 !
+.Ss Unenroll a currently running system
+.Sy Warning :
+The following is a preview feature under development!
+Currently, ports with names beginning with
+.Dq freebsd-
+need to be temporarily uninstalled during this process.
+.Pp
+Systems managed through
+.Xr pkg 8
+can be disassociated from the package manager,
+for example to upgrade in-place via source
+.Xr build 7 .
+.Pp
+To disassociate the base system from the package manager:
+.Bd -literal -offset indent
+pkg unregister -f 'FreeBSD-\e*'
+.Ed
+.Pp
+Disable the base system package repository:
+.Bd -literal -offset indent
+rm /usr/local/etc/pkg/repos/FreeBSD.conf
+.Ed
+.Pp
+.Sy Warning :
+This is a destructive action
+which will prevent updating the base system via
+.Xr pkg 8 !
.Sh SEE ALSO
.Xr build 7 ,
.Xr pkg 8 ,
@@ -225,3 +282,4 @@
Support for installing the base system as packages was introduced in
.Fx 15.0 .
Earlier releases supported a subset of this functionality.
+Support for registering an existing installation appeared in pkg 2.5.

File Metadata

Mime Type
text/plain
Expires
Wed, Mar 4, 4:28 AM (15 h, 41 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
29178229
Default Alt Text
D55458.diff (2 KB)

Event Timeline