DNF4-CONFIG-MANAGER(8)

📦
version 4.7.0 · 7 versions
, in centos-stream 10

🌸 DNF4-CONFIG-MANAGER(8) 🌸

okay so this whole page lives in the dnf-plugins-core manual, bestie, and it's about dnf4-config-manager — the DNF config-manager Plugin. Say it with me: config manager. It's the plug-in that lets you manage main and repository DNF configuration options, toggle which repositories are enabled or disabled, and add new repositories. That's the whole vibe. Slay. 💅

✨ NAME ✨

dnf4-config-manager — the DNF config-manager Plugin, fr fr.

It handles main and repository DNF configuration options, flips repositories between enabled and disabled, and adds brand-new repos. Three jobs, one icon. 👑

🦋 SYNOPSIS 🦋

dnf config-manager [options] <section>...

🎀 ARGUMENTS 🎀

  • <section> — use this to explicitly pick which configuration sections you wanna manage. A section is either main or a repoid (a repo's id, obviously). Now here's the little plot twist: if you don't specify any sections, the program goes ahead and selects the main section plus each repoid used inside any --setopt options. And yes, a repoid can be specified using globs. Globs!! We love a wildcard moment. ⭐

💖 OPTIONS 💖

All general DNF options are accepted, so if you want the full tea just see Options in dnf(8).

  • --help-cmd — shows this help. That's it, that's the whole job. 🫶
  • --add-repo=URL — adds (and enables) the repo from the specified file or url. Now listen, this next bit matters: if it has to be added into installroot, combine it with the --setopt=reposdir=/<installroot>/etc/yum.repos.d command-line option. Combine them. Together. As a team. 🤝
  • --dump — prints a dump of the current configuration values to stdout. Just dumps the whole config right out there. Zero shame. 😭
  • --set-disabled, --disable — disables the specified repos (which implies --save). Bye bye repos, enjoy your nap. 💀
  • --set-enabled, --enable — enables the specified repos (which also implies --save). Welcome back, bestie, we missed you. 🔥
  • --save — saves the current options, super useful together with --setopt. Make it permanent, make it official, make it main character energy. ✨
  • --setopt=<option>=<value> — sets a configuration option. To set configuration options for repositories, use repoid.option for the <option>. And globs are supported in the repoid — yes, more globs, we stay winning. 🌈
WARNING: 🚨 DNF config-manager can misbehave when enabling/disabling repositories generated by tools like subscription-manager on RHEL. In that case you should use subscription-manager to perform such actions. No cap — don't fight the tool, just use the tool. 🙈

🌟 EXAMPLES 🌟

okay here's where it gets good, the receipts:

dnf config-manager --add-repo http://example.com/some/additional.repo Downloads additional.repo and stores it in repodir. Download it, store it, done. 🍓

dnf config-manager --add-repo http://example.com/different/repo Creates a new repo file with http://example.com/different/repo as the baseurl, and enables it. Fresh repo, freshly enabled. 🎀

dnf config-manager --dump Displays the main DNF configuration. The whole main config, right there in your terminal. 👀

dnf config-manager --dump <section> Displays the configuration of a repository identified by <section>. One repo's config, hand-delivered. 💌

dnf config-manager --set-enabled <repoid> Enables the repository identified by <repoid> and makes the change permanent. Permanent means permanent, bestie. 🫶

dnf config-manager --set-disabled <repoid1> <repoid2> Disables the repositories identified by <repoid1> and <repoid2>. Plural. Multiple. A whole situation. 💅

dnf config-manager --set-disabled <repoid1>,<repoid2> Disables the repositories identified by <repoid1> and <repoid2> — same thing, but with a comma this time. Both forms are valid, pick your fighter. 😌

dnf config-manager --save
--setopt=*.proxy=http://proxy.example.com:3128/ <repo1> <repo2>

Updates the proxy setting in repositories with repoid <repo1> and <repo2> and makes the change permanent. Proxy? Set. Permanent? Also set. 🧚

dnf config-manager --save --setopt=*-debuginfo.gpgcheck=0 Updates the gpgcheck setting in all repositories whose id ends with -debuginfo and makes the change permanent. That glob is doing so much work and it's eating, honestly. 🔥

👑 AUTHOR 👑

See AUTHORS in your Core DNF Plugins distribution. That's where the credit lives. Go say hi to them. 💜

2026, Red Hat, Licensed under GPLv2+. Respect the license, love the license. ⭐

and that's the page, bestie!! 🦋 it's version 4.7.0, dated Aug 10, 2026, and it's the dnf-plugins-core manual's very own DNF4-CONFIG-MANAGER(8). go forth and configure, you absolute icon, mwah 💖🎀

📦 where this page comes from