1DNF5-INSTALLROOT(7)                  dnf5                  DNF5-INSTALLROOT(7)
2
3
4

NAME

6       dnf5-installroot - Installroot Parameter
7

DESCRIPTION

9       The  --installroot parameter is used to specify an alternative install‐
10       root, relative to where all packages will be  installed.  Think  of  it
11       like doing chroot <root> dnf, except using --installroot allows DNF5 to
12       work before the chroot is created.
13
14       cachedir, log files, releasever, and gpgkey are taken from or stored in
15       the installroot. GPG keys are imported into the installroot from a path
16       relative to the host which can be specified in the  repository  section
17       of configuration files.
18
19       configuration  file,  reposdir,  and vars are taken from inside the in‐
20       stallroot,  unless  the  command-line  argument  --use-host-config   is
21       passed,  in  which case the configuration and environment from the host
22       system will be used.
23
24       Note: When a path is specified within a command line  argument  (--con‐
25       fig=CONFIG_FILE_PATH  in  case  of  configuration file, --setopt=repos‐
26       dir=/path/to/repodir for reposdir, --setopt=logdir=/path/to/logdir  for
27       logdir, or --setopt=varsdir=/paths/to/varsdir for vars), then this path
28       is always relative to the host with no exceptions. pluginpath and plug‐
29       inconfpath are relative to the host.
30
31       Note: You may also want to use the command-line option --releasever=RE‐
32       LEASEVER when creating the installroot, otherwise the $releasever value
33       is taken from the rpmdb within the installroot (and thus it is empty at
34       the time of creation and the transaction will fail). If  --releasever=/
35       is  used, the releasever will be detected from the host (/) system. The
36       new installroot path at the time  of  creation  does  not  contain  the
37       repository, releasever and dnf.conf files.
38
39       On  a modular system you may also want to use the --setopt=module_plat‐
40       form_id=<module_platform_name:stream> command-line option when creating
41       the  installroot,  otherwise the module_platform_id value will be taken
42       from the /etc/os-release file within the installroot (and thus it  will
43       be  empty  at the time of creation, the modular dependency could be un‐
44       satisfied and modules content could be excluded).
45

EXAMPLES

47       dnf5  --installroot=INSTALLROOT  --releasever=RELEASEVER  install  sys‐
48       tem-release
49              Permanently sets the releasever of the system in the INSTALLROOT
50              directory to RELEASEVER.
51
52       dnf5    --installroot=INSTALLROOT    --setopt=reposdir=PATH    --config
53       /path/dnf.conf upgrade
54              Upgrades  packages  inside the installroot from a repository de‐
55              scribed by --setopt using configuration from /path/dnf.conf.
56

AUTHOR

58       See AUTHORS.md in dnf5 source distribution.
59

61       Contributors to the dnf5 project.
62
63
64
65
66                                 Nov 09, 2023              DNF5-INSTALLROOT(7)
Impressum