FreeBSD Manual Pages
APPJAIL-UPDATE(1) General Commands Manual APPJAIL-UPDATE(1) NAME appjail-update -- Update a thick jail or a release SYNOPSIS appjail update jail [-bfKk] [-j jobs] jail appjail update release [-f] [-a arch] [-v version] [release] DESCRIPTION The appjail update is a utility to fetch and install updates to a jail or a release. The options are as follows: jail [-bfKk] [-j jobs] jail Update jail. You can only update a thick jail, except when it comes from an empty release. This subcommand updates a thick jail using freebsd-update(8) (binary updates) or using the FreeBSD source tree (source updates); However, it depends entirely on how this jail was cre- ated. For thin jails, it is not possible to use this subcommand, but there are at least two methods: the first method uses appjail-etcupdate(8) after updating the release that uses the thin jail and the second method is to separate the data that needs to be persisted from data that is considered ephemeral, so you can destroy and recreate a jail, but preserving the non- ephemeral data. Note that when the jail comes from a build from the FreeBSD source tree, the release is linked indirectly. To detect that the jail comes from a build from the FreeBSD source tree, to obtain the kernel configuration file, architecture, version and other parameters this subcommand uses the release directory, since those parameters are stored there. This is important if you want to export the jail and the release on another system. If jail was created with PkgBase, this subcommand only performs minor updates using pkg(8), using the directory containing the pkg.conf(5) files, which have already been copied by appjail-fetch(1). -b Build the world and, if the kernel was compiled successfully when building the release (and if -K is not specified) or -k is specified, the kernel. -f Force freebsd-update(8) fetch to proceed in the case of an unfinished upgrade. Ignored when the jail was created using a build from the FreeBSD source tree. If the jail was created with PkgBase, then pkg-upgrade(8) will force the reinstallation or upgrade of the whole set of packages. -K By default, this subcommand detects whether a kernel has been compiled successfully when the release is created, so it will proceed to install the kernel again and, if -b is specified, it will build the kernel again. This option disables this be- havior. -k Build and install the kernel even if it is not necessary, that is, when it was not compiled correctly or at all when creating the release. -j jobs Number of jobs. If this option is not set, the number of jobs specified by the JOBS parameter is used. release [-f] [-a arch] [-v version] [release] Update release. A release cannot be updated if it was created using a build from the FreeBSD source tree or if it is an empty release. On the one hand, an empty release is assumed to be the user, you, the only person who knows how to update it, and on the other hand, to up- date a release that was created using a build from the FreeBSD source tree, appjail-fetch(1) should be used and, if your work- flow requires it, you should also use appjail-etcupdate(1) and appjail-deleteOld(1). If release was created with PkgBase, this subcommand only per- forms minor updates using pkg(8), using the directory containing the pkg.conf(5) files, which have already been copied by appjail-fetch(1). -f Force freebsd-update(8) fetch to proceed in the case of an unfinished upgrade. If the release was created with PkgBase, then pkg-upgrade(8) will force the reinstallation or upgrade of the whole set of packages. -a arch Update release with the given architecture. -v version Update release with the given version. ENVIRONMENT PKG_DRY_RUN When a jail or release was created with PkgBase and this environ- ment variable is set, pkg-upgrade(1) runs in dry-run mode. EXIT STATUS The appjail update utility exits 0 on success, and >0 if an error oc- curs. SEE ALSO appjail-checkOld(1) appjail-etcupdate(1) appjail-deleteOld(1) appjail-fetch(1) appjail-upgrade(1) sysexits(3) AUTHORS Jess Daniel Colmenares Oviedo <DtxdF@disroot.org> FreeBSD ports 15.0 September 21, 2025 APPJAIL-UPDATE(1)
NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT | EXIT STATUS | SEE ALSO | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=appjail-update&sektion=1&manpath=FreeBSD+Ports+15.0>