| 1 |
.\" Man page generated from reStructuredText |
| 2 |
.\" by the Docutils 0.22.4 manpage writer. |
| 3 |
. |
| 4 |
. |
| 5 |
.nr rst2man-indent-level 0 |
| 6 |
. |
| 7 |
.de1 rstReportMargin |
| 8 |
\\$1 \\n[an-margin] |
| 9 |
level \\n[rst2man-indent-level] |
| 10 |
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| 11 |
- |
| 12 |
\\n[rst2man-indent0] |
| 13 |
\\n[rst2man-indent1] |
| 14 |
\\n[rst2man-indent2] |
| 15 |
.. |
| 16 |
.de1 INDENT |
| 17 |
.\" .rstReportMargin pre: |
| 18 |
. RS \\$1 |
| 19 |
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] |
| 20 |
. nr rst2man-indent-level +1 |
| 21 |
.\" .rstReportMargin post: |
| 22 |
.. |
| 23 |
.de UNINDENT |
| 24 |
. RE |
| 25 |
.\" indent \\n[an-margin] |
| 26 |
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| 27 |
.nr rst2man-indent-level -1 |
| 28 |
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| 29 |
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u |
| 30 |
.. |
| 31 |
.TH "DNF5-INSTALLROOT" "7" "May 09, 2026" "" "dnf5" |
| 32 |
.SH NAME |
| 33 |
dnf5-installroot \- Installroot Parameter |
| 34 |
.SH DESCRIPTION |
| 35 |
.sp |
| 36 |
The \fB\-\-installroot\fP parameter is used to specify an alternative installroot, |
| 37 |
relative to where all packages will be installed. Think of it like doing |
| 38 |
\fBchroot <root> dnf\fP, except using \fB\-\-installroot\fP allows \fBDNF5\fP to work |
| 39 |
before the chroot is created. |
| 40 |
.sp |
| 41 |
\fIcachedir\fP, \fIsystem_cachedir\fP, \fIlog\fP files, \fIreleasever\fP, and \fIgpgkey\fP are |
| 42 |
taken from or stored in the installroot. OpenPGP keys are imported into the |
| 43 |
installroot from a path relative to the host which can be specified in the |
| 44 |
repository section of configuration files. |
| 45 |
.sp |
| 46 |
\fIconfiguration\fP file, \fIreposdir\fP, and \fIvars\fP are taken from inside the |
| 47 |
installroot, unless the command\-line argument \fB\-\-use\-host\-config\fP is |
| 48 |
passed, in which case the configuration and environment from the host system |
| 49 |
will be used. |
| 50 |
.sp |
| 51 |
Note: When a path is specified within a command line argument |
| 52 |
(\fB\-\-config=CONFIG_FILE_PATH\fP in case of \fIconfiguration\fP file, |
| 53 |
\fB\-\-setopt=reposdir=/path/to/repodir\fP for \fIreposdir\fP, |
| 54 |
\fB\-\-setopt=cachedir=/path/to/cachedir\fP for \fIcachedir\fP, |
| 55 |
\fB\-\-setopt=system_cachedir=/path/to/system_cachedir\fP for \fIsystem_cachedir\fP, |
| 56 |
\fB\-\-setopt=logdir=/path/to/logdir\fP for \fIlogdir\fP, or |
| 57 |
\fB\-\-setopt=varsdir=/paths/to/varsdir\fP for \fIvars\fP), then this path is always |
| 58 |
relative to the host with no exceptions. \fIpluginpath\fP and \fIpluginconfpath\fP are |
| 59 |
relative to the host. |
| 60 |
.sp |
| 61 |
Note: You may also want to use the command\-line option \fB\-\-releasever=RELEASEVER\fP when creating |
| 62 |
the installroot, otherwise the $releasever value is taken from the rpmdb within the installroot |
| 63 |
(and thus it is empty at the time of creation and the transaction will fail). If \fB\-\-use\-host\-config\fP |
| 64 |
is used, the releasever will be detected from the host (/) system. The new installroot path at the |
| 65 |
time of creation does not contain the repository, releasever and dnf.conf files. |
| 66 |
.sp |
| 67 |
On a modular system you may also want to use the \fB\-\-setopt=module_platform_id=<module_platform_name:stream>\fP |
| 68 |
command\-line option when creating the installroot, otherwise the \fBmodule_platform_id\fP value will be |
| 69 |
taken from the \fB/etc/os\-release\fP file within the installroot (and thus it will be empty at the time of |
| 70 |
creation, the modular dependency could be unsatisfied and modules content could be excluded). |
| 71 |
.SH EXAMPLES |
| 72 |
.INDENT 0.0 |
| 73 |
.TP |
| 74 |
.B \fBdnf5 \-\-installroot=INSTALLROOT \-\-releasever=RELEASEVER install system\-release\fP |
| 75 |
Permanently sets the \fBreleasever\fP of the system in the \fBINSTALLROOT\fP directory |
| 76 |
to \fBRELEASEVER\fP\&. |
| 77 |
.TP |
| 78 |
.B \fBdnf5 \-\-installroot=INSTALLROOT \-\-setopt=reposdir=PATH \-\-config /path/dnf.conf upgrade\fP |
| 79 |
Upgrades packages inside the installroot from a repository described by \fB\-\-setopt\fP |
| 80 |
using configuration from \fB/path/dnf.conf\fP\&. |
| 81 |
.UNINDENT |
| 82 |
.SH Author |
| 83 |
See AUTHORS.md in dnf5 source distribution. |
| 84 |
.SH Copyright |
| 85 |
Contributors to the dnf5 project. |
| 86 |
.\" End of generated man page. |