LIBDNF5-LOCAL(8)                     dnf5                     LIBDNF5-LOCAL(8)

NAME
       libdnf5-local - Local Plugin

DESCRIPTION
       After each libdnf5 transaction copy all downloaded packages to local
       repositories on the filesystem and generate repository metadata.

       The plugin creates two repositories:

       o _dnf_local for packages from repositories with pkg_gpgcheck enabled.
         The pkg_gpgcheck setting is inherited from the main configuration.
         The repository doesn't specify any gpgkey, it assumes all required
         keys were already imported.

       o _dnf_local_nogpgcheck for packages from repositories with
         pkg_gpgcheck disabled. This repository has pkg_gpgcheck set to false.

       Each repository is only created when there are cached packages in it.

       Both repositories are configured with the following options:

          skip_if_unavailable = true
          metadata_expire = 0

       The _dnf_local repository has cost = 500 and the _dnf_local_nogpgcheck
       repository has cost = 501, so the gpgcheck-enabled repository is
       preferred when both contain the same package.

       To generate the metadata createrepo_c is required.

CONFIGURATION
       The plugin configuration is in /etc/dnf/libdnf5-plugins/local.conf.
       The minimal content of the conf file should contain main and createrepo
       sections.

       The main section requires:

       name   string <#string-label>

              The plugin's name is local

       enabled
              Whether or where the plugin is enabled: true, false, host-only,
              installroot-only.

              o For host-only the plugin will run only on transactions in the
                default installroot /.

              o For installroot-only the plugin will run only on transactions
                in installroots different from /.

       It can also contain:

       repodir
              string <#string-label>

              Path where the local repository is located.  By default it is in
              persistdir <#persistdir-options-label> in plugins/local
              subdirectory.

       repodir_nogpgcheck
              string <#string-label>

              Path where the local repository for packages from repos with
              pkg_gpgcheck disabled is located.  By default it is in
              persistdir <#persistdir-options-label> in
              plugins/local-nogpgcheck subdirectory.

       The createrepo section requires:

       enabled
              boolean <#boolean-label>

              Whether running createrepo to generate repodata is enabled: true
              or false.

       Additionally it can contain:

       cachedir
              string <#string-label>

              If you want to speed up createrepo with the --cachedir option.
              Not used by default.

       quiet  boolean <#boolean-label>

              Whether to run createrepo with --quiet option. On by default.

       verbose
              boolean <#boolean-label>

              Whether to run createrepo with --verbose option. Off by default.

Author
       See AUTHORS.md in dnf5 source distribution.

Copyright
       Contributors to the dnf5 project.

                                 May 23, 2026                 LIBDNF5-LOCAL(8)