Scroll to navigation

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

NAME

libdnf5-local - Local Plugin

DESCRIPTION

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

The repository is automatically added by the plugin with the following options:

[_dnf_local]
name = Local libdnf5 plugin repo
baseurl = <repodir>
skip_if_unavailable = true
cost = 500
metadata_expire = 0


Note that the repository has pkg_gpgcheck verification enabled by default but doesn't specify any gpgkey, it assumes all required keys were already imported.

To generate the metedata 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:

string <#string-label>

The plugin's name is local

Whether or where the plugin is enabled: true, false, host-only, installroot-only.
  • For host-only the plugin will run only on transactions in the default installroot /.
  • For installroot-only the plugin will run only on transactions in installroots different from /.


It can also contain:

string <#string-label>

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


The createrepo section requires:

boolean <#boolean-label>

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


Additionally it can contain:

string <#string-label>

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

boolean <#boolean-label>

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

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.

January 21, 2026