Debian Codegraph @

upstream/mageia-cauldron/man7/dnf5-installroot.7

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