Debian Codegraph @

upstream/debian-unstable/man7/dnf5-installroot.7

raw
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.