1DNF(8) DNF DNF(8)
2
3
4
6 dnf - DNF Command Reference
7
9 dnf [options] <command> [<args>...]
10
12 DNF is the next upcoming major version of YUM, a package manager for
13 RPM-based Linux distributions. It roughly maintains CLI compatibility
14 with YUM and defines a strict API for extensions and plugins.
15
16 Plugins can modify or extend features of DNF or provide additional CLI
17 commands on top of those mentioned below. If you know the name of such
18 a command (including commands mentioned below), you may find/install
19 the package which provides it using the appropriate virtual provide in
20 the form of dnf-command(<alias>), where <alias> is the name of the com‐
21 mand; e.g.``dnf install 'dnf-command(versionlock)'`` installs a ver‐
22 sionlock plugin. This approach also applies to specifying dependencies
23 of packages that require a particular DNF command.
24
25 Return values:
26
27 · 0 : Operation was successful.
28
29 · 1 : An error occurred, which was handled by dnf.
30
31 · 3 : An unknown unhandled error occurred during operation.
32
33 · 100: See check-update
34
35 · 200: There was a problem with acquiring or releasing of locks.
36
37 Available commands:
38
39 · alias
40
41 · autoremove
42
43 · check
44
45 · check-update
46
47 · clean
48
49 · deplist
50
51 · distro-sync
52
53 · downgrade
54
55 · group
56
57 · help
58
59 · history
60
61 · info
62
63 · install
64
65 · list
66
67 · makecache
68
69 · mark
70
71 · module
72
73 · provides
74
75 · reinstall
76
77 · remove
78
79 · repoinfo
80
81 · repolist
82
83 · repoquery
84
85 · repository-packages
86
87 · search
88
89 · shell
90
91 · swap
92
93 · updateinfo
94
95 · upgrade
96
97 · upgrade-minimal
98
99 · upgrade-to
100
101 Additional information:
102
103 · Options
104
105 · Specifying Packages
106
107 · Specifying Exact Versions of Packages
108
109 · Specifying Provides
110
111 · Specifying Groups
112
113 · Specifying Transactions
114
115 · Metadata Synchronization
116
117 · Configuration Files Replacement Policy
118
119 · Files
120
121 · See Also
122
124 -4 Resolve to IPv4 addresses only.
125
126 -6 Resolve to IPv6 addresses only.
127
128 --advisory=<advisory>, --advisories=<advisory>
129 Include packages corresponding to the advisory ID, Eg.
130 FEDORA-2201-123. Applicable for the install, repoquery, update‐
131 info and upgrade commands.
132
133 --allowerasing
134 Allow erasing of installed packages to resolve dependencies.
135 This option could be used as an alternative to the yum swap com‐
136 mand where packages to remove are not explicitly defined.
137
138 --assumeno
139 Automatically answer no for all questions.
140
141 -b, --best
142 Try the best available package versions in transactions. Specif‐
143 ically during dnf upgrade, which by default skips over updates
144 that can not be installed for dependency reasons, the switch
145 forces DNF to only consider the latest packages. When running
146 into packages with broken dependencies, DNF will fail giving a
147 reason why the latest version can not be installed.
148
149 --bugfix
150 Include packages that fix a bugfix issue. Applicable for the
151 install, repoquery, updateinfo and upgrade commands.
152
153 --bz=<bugzilla>, --bzs=<bugzilla>
154 Include packages that fix a Bugzilla ID, Eg. 123123. Applicable
155 for the install, repoquery, updateinfo and upgrade commands.
156
157 -C, --cacheonly
158 Run entirely from system cache, don't update the cache and use
159 it even in case it is expired.
160
161 DNF uses a separate cache for each user under which it executes.
162 The cache for the root user is called the system cache. This
163 switch allows a regular user read-only access to the system
164 cache, which usually is more fresh than the user's and thus he
165 does not have to wait for metadata sync.
166
167 --color=<color>
168 Control whether color is used in terminal output. Valid values
169 are always, never and auto (default).
170
171 --comment=<comment>
172 Add a comment to the transaction history.
173
174 -c <config file>, --config=<config file>
175 Configuration file location.
176
177 --cve=<cves>, --cves=<cves>
178 Include packages that fix a CVE (Common Vulnerabilities and
179 Exposures) ID (http://cve.mitre.org/about/), Eg. CVE-2201-0123.
180 Applicable for the install, repoquery, updateinfo, and upgrade
181 commands.
182
183 -d <debug level>, --debuglevel=<debug level>
184 Debugging output level. This is an integer value between 0 (no
185 additional information strings) and 10 (shows all debugging
186 information, even that not understandable to the user), default
187 is 2. Deprecated, use -v instead.
188
189 --debugsolver
190 Dump data aiding in dependency solver debugging into ./debug‐
191 data.
192
193 --disableexcludes=[all|main|<repoid>], --disableexcludep‐
194 kgs=[all|main|<repoid>]
195 Disable the configuration file excludes. Takes one of the following
196 three options:
197
198 · all, disables all configuration file excludes
199
200 · main, disables excludes defined in the [main] section
201
202 · repoid, disables excludes defined for the given repository
203
204 --disable, --set-disabled
205 Disable specified repositories (automatically saves). The option
206 has to be used together with the config-manager command
207 (dnf-plugins-core).
208
209 --disableplugin=<plugin names>
210 Disable the listed plugins specified by names or globs.
211
212 --disablerepo=<repoid>
213 Disable specific repositories by an id or a glob. This option is
214 mutually exclusive with --repo.
215
216 --downloaddir=<path>, --destdir=<path>
217 Redirect downloaded packages to provided directory. The option
218 has to be used together with the --downloadonly command line
219 option, with the download command (dnf-plugins-core) or with the
220 system-upgrade command (dnf-plugins-extras).
221
222 --downloadonly
223 Download the resolved package set without performing any rpm
224 transaction (install/upgrade/erase).
225
226 -e <error level>, --errorlevel=<error level>
227 Error output level. This is an integer value between 0 (no error
228 output) and 10 (shows all error messages), default is 3. Depre‐
229 cated, use -v instead.
230
231 --enable, --set-enabled
232 Enable specified repositories (automatically saves). The option
233 has to be used together with the config-manager command
234 (dnf-plugins-core).
235
236 --enableplugin=<plugin names>
237 Enable the listed plugins specified by names or globs.
238
239 --enablerepo=<repoid>
240 Enable additional repositories by an id or a glob.
241
242 --enhancement
243 Include enhancement relevant packages. Applicable for the
244 install, repoquery, updateinfo and upgrade commands.
245
246 -x <package-file-spec>, --exclude=<package-file-spec>
247 Exclude packages specified by <package-file-spec> from the oper‐
248 ation.
249
250 --excludepkgs=<package-file-spec>
251 Deprecated option. It was replaced by the --exclude option.
252
253 --forcearch=<arch>
254 Force the use of an architecture. Any architecture can be speci‐
255 fied. However, use of an architecture not supported natively by
256 your CPU will require emulation of some kind. This is usually
257 through QEMU. The behavior of --forcearch can be configured by
258 using the arch and ignorearch configuration options with values
259 <arch> and True respectively.
260
261 -h, --help, --help-cmd
262 Show the help.
263
264 --installroot=<path>
265 Specifies an alternative installroot, relative to where all
266 packages will be installed. Think of this like doing chroot
267 <root> dnf, except using --installroot allows dnf to work before
268 the chroot is created. It requires absolute path.
269
270 · cachedir, log files, releasever, and gpgkey are taken from or stored
271 in the installroot. Gpgkeys are imported into the installroot from a
272 path relative to the host which can be specified in the repository
273 section of configuration files.
274
275 · configuration file and reposdir are searched inside the installroot
276 first. If they are not present, they are taken from the host system.
277 Note: When a path is specified within a command line argument
278 (--config=<config file> in case of configuration file and
279 --setopt=reposdir=<reposdir> for reposdir) then this path is always
280 relative to the host with no exceptions.
281
282 · vars are taken from the host system or installroot according to
283 reposdir installroot. When varsdir paths are specified within a com‐
284 mand line argument (--setopt=varsdir=<reposdir>) then those path are
285 always relative to the host with no exceptions.
286
287 · The pluginpath and pluginconfpath are relative to the host.
288 Note: You may also want to use the command-line option --relea‐
289 sever=<release> when creating the installroot, otherwise the $relea‐
290 sever value is taken from the rpmdb within the installroot (and thus
291 it is empty at the time of creation and the transaction will fail).
292 If --releasever=/ is used, the releasever will be detected from the
293 host (/) system. The new installroot path at the time of creation
294 does not contain the repository, releasever and dnf.conf files.
295
296 On a modular system you may also want to use the --setopt=mod‐
297 ule_platform_id=<module_platform_name:stream> command-line option
298 when creating the installroot, otherwise the module_platform_id
299 value will be taken from the /etc/os-release file within the
300 installroot (and thus it will be empty at the time of creation, the
301 modular dependency could be unsatisfied and modules content could be
302 excluded).
303
304 Installroot examples:
305
306 dnf --installroot=<installroot> --releasever=<release> install sys‐
307 tem-release
308 Permanently sets the releasever of the system in the
309 <installroot> directory to <release>.
310
311 dnf --installroot=<installroot> --setopt=reposdir=<path> --config
312 /path/dnf.conf upgrade
313 Upgrades packages inside the installroot from a repository
314 described by --setopt using configuration from
315 /path/dnf.conf.
316
317 --newpackage
318 Include newpackage relevant packages. Applicable for the
319 install, repoquery, updateinfo and upgrade commands.
320
321 --noautoremove
322 Disable removal of dependencies that are no longer used. It sets
323 clean_requirements_on_remove configuration option to False.
324
325 --nobest
326 Set best option to False, so that transactions are not limited
327 to best candidates only.
328
329 --nodocs
330 Do not install documentation. Sets the rpm flag 'RPM‐
331 TRANS_FLAG_NODOCS'.
332
333 --nogpgcheck
334 Skip checking GPG signatures on packages (if RPM policy allows).
335
336 --noplugins
337 Disable all plugins.
338
339 --obsoletes
340 This option has an effect on an install/update, it enables dnf's
341 obsoletes processing logic. For more information see the obso‐
342 letes option.
343
344 This option also displays capabilities that the package obso‐
345 letes when used together with the repoquery command.
346
347 Configuration Option: obsoletes
348
349 -q, --quiet
350 In combination with a non-interactive command, shows just the
351 relevant content. Suppresses messages notifying about the cur‐
352 rent state or actions of DNF.
353
354 -R <minutes>, --randomwait=<minutes>
355 Maximum command wait time.
356
357 --refresh
358 Set metadata as expired before running the command.
359
360 --releasever=<release>
361 Configure DNF as if the distribution release was <release>. This
362 can affect cache paths, values in configuration files and mir‐
363 rorlist URLs.
364
365 --repofrompath <repo>,<path/url>
366 Specify a repository to add to the repositories for this query.
367 This option can be used multiple times.
368
369 · The repository label is specified by <repo>.
370
371 · The path or url to the repository is specified by <path/url>. It is
372 the same path as a baseurl and can be also enriched by the repo vari‐
373 ables.
374
375 · The configuration for the repository can be adjusted using -‐
376 -setopt=<repo>.<option>=<value>.
377
378 · If you want to view only packages from this repository, combine this
379 with the --repo=<repo> or --disablerepo="*" switches.
380
381 --repo=<repoid>, --repoid=<repoid>
382 Enable just specific repositories by an id or a glob. Can be
383 used multiple times with accumulative effect. It is basically a
384 shortcut for --disablerepo="*" --enablerepo=<repoid> and is
385 mutually exclusive with the --disablerepo option.
386
387 --rpmverbosity=<name>
388 RPM debug scriptlet output level. Sets the debug level to <name>
389 for RPM scriptlets. For available levels, see the rpmverbosity
390 configuration option.
391
392 --sec-severity=<severity>, --secseverity=<severity>
393 Includes packages that provide a fix for an issue of the speci‐
394 fied severity. Applicable for the install, repoquery, update‐
395 info and upgrade commands.
396
397 --security
398 Includes packages that provide a fix for a security issue.
399 Applicable for the upgrade command.
400
401 --setopt=<option>=<value>
402 Override a configuration option from the configuration file. To
403 override configuration options for repositories, use
404 repoid.option for the <option>. Values for configuration options
405 like excludepkgs, includepkgs, installonlypkgs and tsflags are
406 appended to the original value, they do not override it. How‐
407 ever, specifying an empty value (e.g. --setopt=tsflags=) will
408 clear the option.
409
410 --skip-broken
411 Resolve depsolve problems by removing packages that are causing
412 problems from the transaction. It is an alias for the strict
413 configuration option with value False. Additionally, with the
414 enable and disable module subcommands it allows one to perform
415 an action even in case of broken modular dependencies.
416
417 --showduplicates
418 Show duplicate packages in repositories. Applicable for the list
419 and search commands.
420
421 -v, --verbose
422 Verbose operation, show debug messages.
423
424 --version
425 Show DNF version and exit.
426
427 -y, --assumeyes
428 Automatically answer yes for all questions.
429
430 List options are comma-separated. Command-line options override respec‐
431 tive settings from configuration files.
432
434 For an explanation of <package-spec> and <package-file-spec> see
435 Specifying Packages.
436
437 For an explanation of <package-nevr-spec> see Specifying Exact Versions
438 of Packages.
439
440 For an explanation of <provide-spec> see Specifying Provides.
441
442 For an explanation of <group-spec> see Specifying Groups.
443
444 For an explanation of <module-spec> see Specifying Modules.
445
446 For an explanation of <transaction-spec> see Specifying Transactions.
447
448 Alias Command
449 Allows the user to define and manage a list of aliases (in the form
450 <name=value>), which can be then used as dnf commands to abbreviate
451 longer command sequences. For examples on using the alias command, see
452 Alias Examples. For examples on the alias processing, see Alias Pro‐
453 cessing Examples.
454
455 To use an alias (name=value), the name must be placed as the first
456 "command" (e.g. the first argument that is not an option). It is then
457 replaced by its value and the resulting sequence is again searched for
458 aliases. The alias processing stops when the first found command is not
459 a name of any alias.
460
461 In case the processing would result in an infinite recursion, the orig‐
462 inal arguments are used instead.
463
464 Also, like in shell aliases, if the result starts with a \, the alias
465 processing will stop.
466
467 All aliases are defined in configuration files in the
468 /etc/dnf/aliases.d/ directory in the [aliases] section, and aliases
469 created by the alias command are written to the USER.conf file. In case
470 of conflicts, the USER.conf has the highest priority, and alphabetical
471 ordering is used for the rest of the configuration files.
472
473 Optionally, there is the enabled option in the [main] section default‐
474 ing to True. This can be set for each file separately in the respective
475 file, or globally for all aliases in the ALIASES.conf file.
476
477 dnf alias [options] [list] [<name>...]
478 List aliases with their final result. The [<alias>...] parameter
479 further limits the result to only those aliases matching it.
480
481 dnf alias [options] add <name=value>...
482 Create new aliases.
483
484 dnf alias [options] delete <name>...
485 Delete aliases.
486
487 Alias Examples
488 dnf alias list
489 Lists all defined aliases.
490
491 dnf alias add rm=remove
492 Adds a new command alias called rm which works the same as the
493 remove command.
494
495 dnf alias add upgrade="\upgrade --skip-broken --disableexcludes=all
496 --obsoletes"
497 Adds a new command alias called upgrade which works the same as
498 the upgrade command, with additional options. Note that the
499 original upgrade command is prefixed with a \ to prevent an
500 infinite loop in alias processing.
501
502 Alias Processing Examples
503 If there are defined aliases in=install and FORCE="--skip-broken --dis‐
504 ableexcludes=all":
505
506 · dnf FORCE in will be replaced with dnf --skip-broken --disableex‐
507 cludes=all install
508
509 · dnf in FORCE will be replaced with dnf install FORCE (which will
510 fail)
511
512 If there is defined alias in=install:
513
514 · dnf in will be replaced with dnf install
515
516 · dnf --repo updates in will be replaced with dnf --repo updates in
517 (which will fail)
518
519 Auto Remove Command
520 dnf [options] autoremove
521 Removes all "leaf" packages from the system that were originally
522 installed as dependencies of user-installed packages, but which are
523 no longer required by any such package.
524
525 Packages listed in installonlypkgs are never automatically removed by
526 this command.
527
528 dnf [options] autoremove <spec>...
529 This is an alias for the Remove Command command with clean_require‐
530 ments_on_remove set to True. It removes the specified packages from
531 the system along with any packages depending on the packages being
532 removed. Each <spec> can be either a <package-spec>, which specifies
533 a package directly, or a @<group-spec>, which specifies an (environ‐
534 ment) group which contains it. It also removes any dependencies that
535 are no longer needed.
536
537 There are also a few specific autoremove commands autoremove-n,
538 autoremove-na and autoremove-nevra that allow the specification of
539 an exact argument in the NEVRA (name-epoch:version-release.architec‐
540 ture) format.
541
542 This command by default does not force a sync of expired metadata. See
543 also Metadata Synchronization.
544
545 Check Command
546 dnf [options] check [--dependencies] [--duplicates] [--obsoleted]
547 [--provides]
548 Checks the local packagedb and produces information on any problems
549 it finds. You can limit the checks to be performed by using the
550 --dependencies, --duplicates, --obsoleted and --provides options
551 (the default is to check everything).
552
553 Check-Update Command
554 dnf [options] check-update [--changelogs] [<package-file-spec>...]
555 Non-interactively checks if updates of the specified packages are
556 available. If no <package-file-spec> is given, checks whether any
557 updates at all are available for your system. DNF exit code will be
558 100 when there are updates available and a list of the updates will
559 be printed, 0 if not and 1 if an error occurs. If --changelogs
560 option is specified, also changelog delta of packages about to be
561 updated is printed.
562
563 Please note that having a specific newer version available for an
564 installed package (and reported by check-update) does not imply that
565 subsequent dnf upgrade will install it. The difference is that dnf
566 upgrade has restrictions (like package dependencies being satisfied)
567 to take into account.
568
569 The output is affected by the autocheck_running_kernel configuration
570 option.
571
572 Clean Command
573 Performs cleanup of temporary files kept for repositories. This
574 includes any such data left behind from disabled or removed reposito‐
575 ries as well as for different distribution release versions.
576
577 dnf clean dbcache
578 Removes cache files generated from the repository metadata. This
579 forces DNF to regenerate the cache files the next time it is
580 run.
581
582 dnf clean expire-cache
583 Marks the repository metadata expired. DNF will re-validate the
584 cache for each repository the next time it is used.
585
586 dnf clean metadata
587 Removes repository metadata. Those are the files which DNF uses
588 to determine the remote availability of packages. Using this
589 option will make DNF download all the metadata the next time it
590 is run.
591
592 dnf clean packages
593 Removes any cached packages from the system.
594
595 dnf clean all
596 Does all of the above.
597
598 Deplist command
599 dnf [options] deplist [<select-options>] [<query-options>] [<pack‐
600 age-spec>]
601 Alias for dnf repoquery --deplist.
602
603 Distro-Sync command
604 dnf distro-sync [<package-spec>...]
605 As necessary upgrades, downgrades or keeps selected installed
606 packages to match the latest version available from any enabled
607 repository. If no package is given, all installed packages are
608 considered.
609
610 See also Configuration Files Replacement Policy.
611
612 Distribution-Synchronization command
613 dnf distribution-synchronization
614 Deprecated alias for the Distro-Sync command.
615
616 Downgrade Command
617 dnf [options] downgrade <package-spec>...
618 Downgrades the specified packages to the highest installable
619 package of all known lower versions if possible. When version is
620 given and is lower than version of installed package then it
621 downgrades to target version.
622
623 Erase Command
624 dnf [options] erase <spec>...
625 Deprecated alias for the Remove Command.
626
627 Group Command
628 Groups are virtual collections of packages. DNF keeps track of groups
629 that the user selected ("marked") installed and can manipulate the com‐
630 prising packages with simple commands.
631
632 dnf [options] group [summary] <group-spec>
633 Display overview of how many groups are installed and available.
634 With a spec, limit the output to the matching groups. summary is
635 the default groups subcommand.
636
637 dnf [options] group info <group-spec>
638 Display package lists of a group. Shows which packages are
639 installed or available from a repository when -v is used.
640
641 dnf [options] group install [--with-optional] <group-spec>...
642 Mark the specified group installed and install packages it con‐
643 tains. Also include optional packages of the group if
644 --with-optional is specified. All mandatory and Default packages
645 will be installed whenever possible. Conditional packages are
646 installed if they meet their requirement. If the group is
647 already (partially) installed, the command installs the missing
648 packages from the group. Depending on the value of obsoletes
649 configuration option group installation takes obsoletes into
650 account.
651
652 dnf [options] group list <group-spec>...
653 List all matching groups, either among installed or available
654 groups. If nothing is specified, list all known groups.
655 --installed and --available options narrow down the requested
656 list. Records are ordered by the display_order tag defined in
657 comps.xml file. Provides a list of all hidden groups by using
658 option --hidden. Provides group IDs when the -v or --ids
659 options are used.
660
661 dnf [options] group remove <group-spec>...
662 Mark the group removed and remove those packages in the group
663 from the system which do not belong to another installed group
664 and were not installed explicitly by the user.
665
666 dnf [options] group upgrade <group-spec>...
667 Upgrades the packages from the group and upgrades the group
668 itself. The latter comprises of installing packages that were
669 added to the group by the distribution and removing packages
670 that got removed from the group as far as they were not
671 installed explicitly by the user.
672
673 Groups can also be marked installed or removed without physically
674 manipulating any packages:
675
676 dnf [options] group mark install <group-spec>...
677 Mark the specified group installed. No packages will be
678 installed by this command, but the group is then considered
679 installed.
680
681 dnf [options] group mark remove <group-spec>...
682 Mark the specified group removed. No packages will be removed by
683 this command.
684
685 See also Configuration Files Replacement Policy.
686
687 Groups Command
688 dnf [options] groups
689 Deprecated alias for the Group Command.
690
691 Help Command
692 dnf help [<command>]
693 Displays the help text for all commands. If given a command name
694 then only displays help for that particular command.
695
696 History Command
697 The history command allows the user to view what has happened in past
698 transactions and act according to this information (assuming the his‐
699 tory_record configuration option is set).
700
701 dnf history [list] [<spec>...]
702 The default history action is listing information about given
703 transactions in a table. Each <spec> can be either a <transac‐
704 tion-spec>, which specifies a transaction directly, or a <trans‐
705 action-spec>..<transaction-spec>, which specifies a range of
706 transactions, or a <package-name-spec>, which specifies a trans‐
707 action by a package which it manipulated. When no transaction is
708 specified, list all known transactions.
709
710 dnf history info [<spec>...]
711 Describe the given transactions. The meaning of <spec> is the
712 same as in the History List Command. When no transaction is
713 specified, describe what happened during the latest transaction.
714
715 dnf history redo <transaction-spec>|<package-file-spec>
716 Repeat the specified transaction. Uses the last transaction
717 (with the highest ID) if more than one transaction for given
718 <package-file-spec> is found. If it is not possible to redo some
719 operations due to the current state of RPMDB, it will not redo
720 the transaction.
721
722 dnf history rollback <transaction-spec>|<package-file-spec>
723 Undo all transactions performed after the specified transaction.
724 Uses the last transaction (with the highest ID) if more than one
725 transaction for given <package-file-spec> is found. If it is
726 not possible to undo some transactions due to the current state
727 of RPMDB, it will not undo any transaction.
728
729 dnf history undo <transaction-spec>|<package-file-spec>
730 Perform the opposite operation to all operations performed in
731 the specified transaction. Uses the last transaction (with the
732 highest ID) if more than one transaction for given <pack‐
733 age-file-spec> is found. If it is not possible to undo some
734 operations due to the current state of RPMDB, it will not undo
735 the transaction.
736
737 dnf history userinstalled
738 Show all installonly packages, packages installed outside of DNF
739 and packages not installed as dependency. I.e. it lists packages
740 that will stay on the system when Auto Remove Command or Remove
741 Command along with clean_requirements_on_remove configuration
742 option set to True is executed. Note the same results can be
743 accomplished with dnf repoquery --userinstalled, and the repo‐
744 query command is more powerful in formatting of the output.
745
746 This command by default does not force a sync of expired metadata,
747 except for the redo, rollback, and undo subcommands. See also Metadata
748 Synchronization and Configuration Files Replacement Policy.
749
750 Info Command
751 dnf [options] info [<package-file-spec>...]
752 Lists description and summary information about installed and
753 available packages.
754
755 The info command limits the displayed packages the same way as the list
756 command.
757
758 This command by default does not force a sync of expired metadata. See
759 also Metadata Synchronization.
760
761 Install Command
762 dnf [options] install <spec>...
763 Makes sure that the given packages and their dependencies are
764 installed on the system. Each <spec> can be either a
765 <package-spec>, or a @<module-spec>, or a @<group-spec>. See
766 Install Examples. If a given package or provide cannot be (and
767 is not already) installed, the exit code will be non-zero. If
768 the <spec> matches both a @<module-spec> and a @<group-spec>,
769 only the module is installed.
770
771 When <package-spec> to specify the exact version of the package
772 is given, DNF will install the desired version, no matter which
773 version of the package is already installed. The former version
774 of the package will be removed in the case of non-installonly
775 package.
776
777 There are also a few specific install commands install-n,
778 install-na and install-nevra that allow the specification of an
779 exact argument in the NEVRA format.
780
781 See also Configuration Files Replacement Policy.
782
783 Install Examples
784 dnf install tito
785 Install the tito package (tito is the package name).
786
787 dnf install ~/Downloads/tito-0.6.2-1.fc22.noarch.rpm
788 Install a local rpm file tito-0.6.2-1.fc22.noarch.rpm from the
789 ~/Downloads/ directory.
790
791 dnf install tito-0.5.6-1.fc22
792 Install the package with a specific version. If the package is
793 already installed it will automatically try to downgrade or
794 upgrade to the specific version.
795
796 dnf --best install tito
797 Install the latest available version of the package. If the
798 package is already installed it will try to automatically
799 upgrade to the latest version. If the latest version of the
800 package cannot be installed, the installation will fail.
801
802 dnf install vim
803 DNF will automatically recognize that vim is not a package name,
804 but will look up and install a package that provides vim with
805 all the required dependencies. Note: Package name match has
806 precedence over package provides match.
807
808 dnf install https://kojipkgs.fedoraproject.org//pack‐
809 ages/tito/0.6.0/1.fc22/noarch/tito-0.6.0-1.fc22.noarch.rpm
810 Install a package directly from a URL.
811
812 dnf install '@docker'
813 Install all default profiles of module 'docker' and their RPMs.
814 Module streams get enabled accordingly.
815
816 dnf install '@Web Server'
817 Install the 'Web Server' environmental group.
818
819 dnf install /usr/bin/rpmsign
820 Install a package that provides the /usr/bin/rpmsign file.
821
822 dnf -y install tito --setopt=install_weak_deps=False
823 Install the tito package (tito is the package name) without weak
824 deps. Weak deps are not required for core functionality of the
825 package, but they enhance the original package (like extended
826 documentation, plugins, additional functions, etc.).
827
828 dnf install --advisory=FEDORA-2018-b7b99fe852 \*
829 Install all packages that belong to the "FEDORA-2018-b7b99fe852"
830 advisory.
831
832 List Command
833 Prints lists of packages depending on the packages' relation to the
834 system. A package is installed if it is present in the RPMDB, and it is
835 available if it is not installed but is present in a repository that
836 DNF knows about.
837
838 The list command also limits the displayed packages according to spe‐
839 cific criteria, e.g. to only those that update an installed package
840 (respecting the repository priority). The exclude option in the config‐
841 uration file can influence the result, but if the --disableexcludes
842 command line option is used, it ensures that all installed packages
843 will be listed.
844
845 dnf [options] list [--all] [<package-file-spec>...]
846 Lists all packages, present in the RPMDB, in a repository or
847 both.
848
849 dnf [options] list --installed [<package-file-spec>...]
850 Lists installed packages.
851
852 dnf [options] list --available [<package-file-spec>...]
853 Lists available packages.
854
855 dnf [options] list --extras [<package-file-spec>...]
856 Lists extras, that is packages installed on the system that are
857 not available in any known repository.
858
859 dnf [options] list --obsoletes [<package-file-spec>...]
860 List packages installed on the system that are obsoleted by
861 packages in any known repository.
862
863 dnf [options] list --recent [<package-file-spec>...]
864 List packages recently added into the repositories.
865
866 dnf [options] list --upgrades [<package-file-spec>...]
867 List upgrades available for the installed packages.
868
869 dnf [options] list --autoremove
870 List packages which will be removed by the dnf autoremove com‐
871 mand.
872
873 This command by default does not force a sync of expired metadata. See
874 also Metadata Synchronization.
875
876 Localinstall Command
877 dnf [options] localinstall <spec>...
878 Deprecated alias for the Install Command.
879
880 Makecache Command
881 dnf [options] makecache
882 Downloads and caches metadata for all known repos. Tries to
883 avoid downloading whenever possible (e.g. when the local meta‐
884 data hasn't expired yet or when the metadata timestamp hasn't
885 changed).
886
887 dnf [options] makecache --timer
888 Like plain makecache, but instructs DNF to be more
889 resource-aware, meaning it will not do anything if running on
890 battery power and will terminate immediately if it's too soon
891 after the last successful makecache run (see dnf.conf(5), meta‐
892 data_timer_sync).
893
894 Mark Command
895 dnf mark install <package-spec>...
896 Marks the specified packages as installed by user. This can be
897 useful if any package was installed as a dependency and is
898 desired to stay on the system when Auto Remove Command or Remove
899 Command along with clean_requirements_on_remove configuration
900 option set to True is executed.
901
902 dnf mark remove <package-spec>...
903 Unmarks the specified packages as installed by user. Whenever
904 you as a user don't need a specific package you can mark it for
905 removal. The package stays installed on the system but will be
906 removed when Auto Remove Command or Remove Command along with
907 clean_requirements_on_remove configuration option set to True is
908 executed. You should use this operation instead of Remove Com‐
909 mand if you're not sure whether the package is a requirement of
910 other user installed packages on the system.
911
912 dnf mark group <package-spec>...
913 Marks the specified packages as installed by group. This can be
914 useful if any package was installed as a dependency or a user
915 and is desired to be protected and handled as a group member
916 like during group remove.
917
918 Module Command
919 Modularity overview is available at man page dnf.modularity(7). Module
920 subcommands take <module-spec>... arguments that specify modules or
921 profiles.
922
923 dnf [options] module install <module-spec>...
924 Install module profiles, including their packages. In case no
925 profile was provided, all default profiles get installed. Mod‐
926 ule streams get enabled accordingly.
927
928 This command cannot be used for switching module streams. It is
929 recommended to remove all installed content from the module and
930 reset the module using the reset command. After you reset the
931 module, you can install the other stream.
932
933 dnf [options] module update <module-spec>...
934 Update packages associated with an active module stream, option‐
935 ally restricted to a profile. If the profile_name is provided,
936 only the packages referenced by that profile will be updated.
937
938 dnf [options] module remove <module-spec>...
939 Remove installed module profiles, including packages that were
940 installed with the dnf module install command. Will not remove
941 packages required by other installed module profiles or by other
942 user-installed packages. In case no profile was provided, all
943 installed profiles get removed.
944
945 dnf [options] module remove --all <module-spec>...
946 Remove installed module profiles, including packages that were
947 installed with the dnf module install command. With --all
948 option it additionally removes all packages whose names are pro‐
949 vided by specified modules. Packages required by other installed
950 module profiles and packages whose names are also provided by
951 any other module are not removed.
952
953 dnf [options] module enable <module-spec>...
954 Enable a module stream and make the stream RPMs available in the
955 package set.
956
957 Modular dependencies are resolved, dependencies checked and also
958 recursively enabled. In case of modular dependency issue the
959 operation will be rejected. To perform the action anyway please
960 use --skip-broken option.
961
962 This command cannot be used for switching module streams. It is
963 recommended to remove all installed content from the module, and
964 reset the module using the reset command. After you reset the
965 module, you can enable the other stream.
966
967 dnf [options] module disable <module-name>...
968 Disable a module. All related module streams will become
969 unavailable. Consequently, all installed profiles will be
970 removed and the module RPMs will become unavailable in the pack‐
971 age set. In case of modular dependency issue the operation will
972 be rejected. To perform the action anyway please use -‐
973 -skip-broken option.
974
975 dnf [options] module reset <module-name>...
976 Reset module state so it's no longer enabled or disabled. Con‐
977 sequently, all installed profiles will be removed and only RPMs
978 from the default stream will be available in the package set.
979
980 dnf [options] module provides <package-name-spec>...
981 Lists all modular packages matching <package-name-spec> from all
982 modules (including disabled), along with the modules and streams
983 they belong to.
984
985 dnf [options] module list [--all] [module_name...]
986 Lists all module streams, their profiles and states (enabled,
987 disabled, default).
988
989 dnf [options] module list --enabled [module_name...]
990 Lists module streams that are enabled.
991
992 dnf [options] module list --disabled [module_name...]
993 Lists module streams that are disabled.
994
995 dnf [options] module list --installed [module_name...]
996 List module streams with installed profiles.
997
998 dnf [options] module info <module-spec>...
999 Print detailed information about given module stream.
1000
1001 dnf [options] module info --profile <module-spec>...
1002 Print detailed information about given module profiles.
1003
1004 dnf [options] module repoquery <module-spec>...
1005 List all available packages belonging to selected modules.
1006
1007 dnf [options] module repoquery --available <module-spec>...
1008 List all available packages belonging to selected modules.
1009
1010 dnf [options] module repoquery --installed <module-spec>...
1011 List all installed packages with same name like packages belong‐
1012 ing to selected modules.
1013
1014 Provides Command
1015 dnf [options] provides <provide-spec>
1016 Finds the packages providing the given <provide-spec>. This is
1017 useful when one knows a filename and wants to find what package
1018 (installed or not) provides this file. The <provide-spec> is
1019 gradually looked for at following locations:
1020
1021 1. The <provide-spec> is matched with all file provides of any
1022 available package:
1023
1024 $ dnf provides /usr/bin/gzip
1025 gzip-1.9-9.fc29.x86_64 : The GNU data compression program
1026 Matched from:
1027 Filename : /usr/bin/gzip
1028
1029 2. Then all provides of all available packages are searched:
1030
1031 $ dnf provides "gzip(x86-64)"
1032 gzip-1.9-9.fc29.x86_64 : The GNU data compression program
1033 Matched from:
1034 Provide : gzip(x86-64) = 1.9-9.fc29
1035
1036 3. DNF assumes that the <provide-spec> is a system command,
1037 prepends it with /usr/bin/, /usr/sbin/ prefixes (one at a
1038 time) and does the file provides search again. For legacy
1039 reasons (packages that didn't do UsrMove) also /bin and /sbin
1040 prefixes are being searched:
1041
1042 $ dnf provides zless
1043 gzip-1.9-9.fc29.x86_64 : The GNU data compression program
1044 Matched from:
1045 Filename : /usr/bin/zless
1046
1047 4. If this last step also fails, DNF returns "Error: No Matches
1048 found".
1049
1050 This command by default does not force a sync of expired meta‐
1051 data. See also Metadata Synchronization.
1052
1053 Reinstall Command
1054 dnf [options] reinstall <package-spec>...
1055 Installs the specified packages, fails if some of the packages
1056 are either not installed or not available (i.e. there is no
1057 repository where to download the same RPM).
1058
1059 Remove Command
1060 dnf [options] remove <package-spec>...
1061 Removes the specified packages from the system along with any
1062 packages depending on the packages being removed. Each <spec>
1063 can be either a <package-spec>, which specifies a package
1064 directly, or a @<group-spec>, which specifies an (environment)
1065 group which contains it. If clean_requirements_on_remove is
1066 enabled (the default), also removes any dependencies that are no
1067 longer needed.
1068
1069 dnf [options] remove --duplicates
1070 Removes older versions of duplicate packages. To ensure the
1071 integrity of the system it reinstalls the newest package. In
1072 some cases the command cannot resolve conflicts. In such cases
1073 the dnf shell command with remove --duplicates and upgrade
1074 dnf-shell sub-commands could help.
1075
1076 dnf [options] remove --oldinstallonly
1077 Removes old installonly packages, keeping only latest versions
1078 and version of running kernel.
1079
1080 There are also a few specific remove commands remove-n,
1081 remove-na and remove-nevra that allow the specification of an
1082 exact argument in the NEVRA format.
1083
1084 Remove Examples
1085 dnf remove acpi tito
1086 Remove the acpi and tito packages.
1087
1088 dnf remove $(dnf repoquery --extras --exclude=tito,acpi)
1089 Remove packages not present in any repository, but don't remove
1090 the tito and acpi packages (they still might be removed if they
1091 depend on some of the removed packages).
1092
1093 Remove older versions of duplicated packages (an equivalent of yum's
1094 package-cleanup --cleandups):
1095
1096 dnf remove --duplicates
1097
1098 Repoinfo Command
1099 An alias for the repolist command that provides more detailed infor‐
1100 mation like dnf repolist -v.
1101
1102 Repolist Command
1103 dnf [options] repolist [--enabled|--disabled|--all]
1104 Depending on the exact command lists enabled, disabled or all
1105 known repositories. Lists all enabled repositories by default.
1106 Provides more detailed information when -v option is used.
1107
1108 This command by default does not force a sync of expired metadata. See
1109 also Metadata Synchronization.
1110
1111 Repoquery Command
1112 dnf [options] repoquery [<select-options>] [<query-options>] [<pack‐
1113 age-file-spec>]
1114 Searches available DNF repositories for selected packages and
1115 displays the requested information about them. It is an equiva‐
1116 lent of rpm -q for remote repositories.
1117
1118 dnf [options] repoquery --querytags
1119 Provides the list of tags recognized by the --queryformat repo‐
1120 query option.
1121
1122 There are also a few specific repoquery commands repoquery-n,
1123 repoquery-na and repoquery-nevra that allow the specification of
1124 an exact argument in the NEVRA format (does not affect arguments
1125 of options like --whatprovides <arg>, ...).
1126
1127 Select Options
1128 Together with <package-file-spec>, control what packages are displayed
1129 in the output. If <package-file-spec> is given, limits the resulting
1130 set of packages to those matching the specification. All packages are
1131 considered if no <package-file-spec> is specified.
1132
1133 <package-file-spec>
1134 Package specification in the NEVRA format (name[-[epoch:]ver‐
1135 sion[-release]][.arch]), a package provide or a file provide.
1136 See Specifying Packages.
1137
1138 -a, --all
1139 Query all packages (for rpmquery compatibility, also a shorthand
1140 for repoquery '*' or repoquery without arguments).
1141
1142 --arch <arch>[,<arch>...], --archlist <arch>[,<arch>...]
1143 Limit the resulting set only to packages of selected architec‐
1144 tures (default is all architectures). In some cases the result
1145 is affected by the basearch of the running system, therefore to
1146 run repoquery for an arch incompatible with your system use the
1147 --forcearch=<arch> option to change the basearch.
1148
1149 --duplicates
1150 Limit the resulting set to installed duplicate packages (i.e.
1151 more package versions for the same name and architecture).
1152 Installonly packages are excluded from this set.
1153
1154 --unneeded
1155 Limit the resulting set to leaves packages that were installed
1156 as dependencies so they are no longer needed. This switch lists
1157 packages that are going to be removed after executing the dnf
1158 autoremove command.
1159
1160 --available
1161 Limit the resulting set to available packages only (set by
1162 default).
1163
1164 --disable-modular-filtering
1165 Disables filtering of modular packages, so that packages of
1166 inactive module streams are included in the result.
1167
1168 --extras
1169 Limit the resulting set to packages that are not present in any
1170 of the available repositories.
1171
1172 -f <file>, --file <file>
1173 Limit the resulting set only to the package that owns <file>.
1174
1175 --installed
1176 Limit the resulting set to installed packages only. The exclude
1177 option in the configuration file might influence the result, but
1178 if the command line option --disableexcludes is used, it
1179 ensures that all installed packages will be listed.
1180
1181 --installonly
1182 Limit the resulting set to installed installonly packages.
1183
1184 --latest-limit <number>
1185 Limit the resulting set to <number> of latest packages for every
1186 package name and architecture. If <number> is negative, skip
1187 <number> of latest packages. For a negative <number> use the
1188 --latest-limit=<number> syntax.
1189
1190 --recent
1191 Limit the resulting set to packages that were recently edited.
1192
1193 --repo <repoid>
1194 Limit the resulting set only to packages from a repository iden‐
1195 tified by <repoid>. Can be used multiple times with accumula‐
1196 tive effect.
1197
1198 --unsatisfied
1199 Report unsatisfied dependencies among installed packages (i.e.
1200 missing requires and and existing conflicts).
1201
1202 --upgrades
1203 Limit the resulting set to packages that provide an upgrade for
1204 some already installed package.
1205
1206 --userinstalled
1207 Limit the resulting set to packages installed by the user. The
1208 exclude option in the configuration file might influence the
1209 result, but if the command line option --disableexcludes is
1210 used, it ensures that all installed packages will be listed.
1211
1212 --whatdepends <capability>[,<capability>...]
1213 Limit the resulting set only to packages that require, enhance,
1214 recommend, suggest or supplement any of <capabilities>.
1215
1216 --whatconflicts <capability>[,<capability>...]
1217 Limit the resulting set only to packages that conflict with any
1218 of <capabilities>.
1219
1220 --whatenhances <capability>[,<capability>...]
1221 Limit the resulting set only to packages that enhance any of
1222 <capabilities>. Use --whatdepends if you want to list all
1223 depending packages.
1224
1225 --whatobsoletes <capability>[,<capability>...]
1226 Limit the resulting set only to packages that obsolete any of
1227 <capabilities>.
1228
1229 --whatprovides <capability>[,<capability>...]
1230 Limit the resulting set only to packages that provide any of
1231 <capabilities>.
1232
1233 --whatrecommends <capability>[,<capability>...]
1234 Limit the resulting set only to packages that recommend any of
1235 <capabilities>. Use --whatdepends if you want to list all
1236 depending packages.
1237
1238 --whatrequires <capability>[,<capability>...]
1239 Limit the resulting set only to packages that require any of
1240 <capabilities>. Use --whatdepends if you want to list all
1241 depending packages.
1242
1243 --whatsuggests <capability>[,<capability>...]
1244 Limit the resulting set only to packages that suggest any of
1245 <capabilities>. Use --whatdepends if you want to list all
1246 depending packages.
1247
1248 --whatsupplements <capability>[,<capability>...]
1249 Limit the resulting set only to packages that supplement any of
1250 <capabilities>. Use --whatdepends if you want to list all
1251 depending packages.
1252
1253 --alldeps
1254 This option is stackable with --whatrequires or --whatdepends
1255 only. Additionally it adds all packages requiring the package
1256 features to the result set (used as default).
1257
1258 --exactdeps
1259 This option is stackable with --whatrequires or --whatdepends
1260 only. Limit the resulting set only to packages that require
1261 <capability> specified by --whatrequires.
1262
1263 --srpm Operate on the corresponding source RPM.
1264
1265 Query Options
1266 Set what information is displayed about each package.
1267
1268 The following are mutually exclusive, i.e. at most one can be speci‐
1269 fied. If no query option is given, matching packages are displayed in
1270 the standard NEVRA notation.
1271
1272 -i, --info
1273 Show detailed information about the package.
1274
1275 -l, --list
1276 Show the list of files in the package.
1277
1278 -s, --source
1279 Show the package source RPM name.
1280
1281 --changelogs
1282 Print the package changelogs.
1283
1284 --conflicts
1285 Display capabilities that the package conflicts with. Same as
1286 --qf "%{conflicts}.
1287
1288 --depends
1289 Display capabilities that the package depends on, enhances, rec‐
1290 ommends, suggests or supplements.
1291
1292 --enhances
1293 Display capabilities enhanced by the package. Same as --qf
1294 "%{enhances}"".
1295
1296 --location
1297 Show a location where the package could be downloaded from.
1298
1299 --obsoletes
1300 Display capabilities that the package obsoletes. Same as --qf
1301 "%{obsoletes}".
1302
1303 --provides
1304 Display capabilities provided by the package. Same as --qf
1305 "%{provides}".
1306
1307 --recommends
1308 Display capabilities recommended by the package. Same as --qf
1309 "%{recommends}".
1310
1311 --requires
1312 Display capabilities that the package depends on. Same as --qf
1313 "%{requires}".
1314
1315 --requires-pre
1316 Display capabilities that the package depends on for running a
1317 %pre script. Same as --qf "%{requires-pre}".
1318
1319 --suggests
1320 Display capabilities suggested by the package. Same as --qf
1321 "%{suggests}".
1322
1323 --supplements
1324 Display capabilities supplemented by the package. Same as --qf
1325 "%{supplements}".
1326
1327 --tree Display a recursive tree of packages with capabilities specified
1328 by one of the following supplementary options: --whatrequires,
1329 --requires, --conflicts, --enhances, --suggests, --provides,
1330 --supplements, --recommends.
1331
1332 --deplist
1333 Produce a list of all direct dependencies and what packages pro‐
1334 vide those dependencies for the given packages. The result only
1335 shows the newest providers (which can be changed by using --ver‐
1336 bose).
1337
1338 --nvr Show found packages in the name-version-release format. Same as
1339 --qf "%{name}-%{version}-%{release}".
1340
1341 --nevra
1342 Show found packages in the name-epoch:version-release.architec‐
1343 ture format. Same as --qf "%{name}-%{epoch}:%{ver‐
1344 sion}-%{release}.%{arch}" (default).
1345
1346 --envra
1347 Show found packages in the epoch:name-version-release.architec‐
1348 ture format. Same as --qf "%{epoch}:%{name}-%{ver‐
1349 sion}-%{release}.%{arch}"
1350
1351 --qf <format>, --queryformat <format>
1352 Custom display format. <format> is the string to output for each
1353 matched package. Every occurrence of %{<tag>} within is replaced
1354 by the corresponding attribute of the package. The list of rec‐
1355 ognized tags can be displayed by running dnf repoquery --query‐
1356 tags.
1357
1358 --recursive
1359 Query packages recursively. Has to be used with --whatrequires
1360 <REQ> (optionally with --alldeps, but not with --exactdeps) or
1361 with --requires <REQ> --resolve.
1362
1363 --resolve
1364 resolve capabilities to originating package(s).
1365
1366 Examples
1367 Display NEVRAs of all available packages matching light*:
1368
1369 dnf repoquery 'light*'
1370
1371 Display NEVRAs of all available packages matching name light* and
1372 architecture noarch (accepts only arguments in the "<name>.<arch>" for‐
1373 mat):
1374
1375 dnf repoquery-na 'light*.noarch'
1376
1377 Display requires of all lighttpd packages:
1378
1379 dnf repoquery --requires lighttpd
1380
1381 Display packages providing the requires of python packages:
1382
1383 dnf repoquery --requires python --resolve
1384
1385 Display source rpm of ligttpd package:
1386
1387 dnf repoquery --source lighttpd
1388
1389 Display package name that owns the given file:
1390
1391 dnf repoquery --file /etc/lighttpd/lighttpd.conf
1392
1393 Display name, architecture and the containing repository of all
1394 lighttpd packages:
1395
1396 dnf repoquery --queryformat '%{name}.%{arch} : %{reponame}' lighttpd
1397
1398 Display all available packages providing "webserver":
1399
1400 dnf repoquery --whatprovides webserver
1401
1402 Display all available packages providing "webserver" but only for
1403 "i686" architecture:
1404
1405 dnf repoquery --whatprovides webserver --arch i686
1406
1407 Display duplicate packages:
1408
1409 dnf repoquery --duplicates
1410
1411 Display source packages that require a <provide> for a build:
1412
1413 dnf repoquery --disablerepo="*" --enablerepo="*-source" --arch=src --whatrequires <provide>
1414
1415 Repo-Pkgs Command
1416 dnf [options] repo-pkgs
1417 Deprecated alias for the Repository-Packages Command.
1418
1419 Repository-Packages Command
1420 The repository-packages command allows the user to run commands on top
1421 of all packages in the repository named <repoid>. However, any depen‐
1422 dency resolution takes into account packages from all enabled reposito‐
1423 ries. The <package-file-spec> and <package-spec> specifications further
1424 limit the candidates to only those packages matching at least one of
1425 them.
1426
1427 The info subcommand lists description and summary information about
1428 packages depending on the packages' relation to the repository. The
1429 list subcommand just prints lists of those packages.
1430
1431 dnf [options] repository-packages <repoid> check-update [<pack‐
1432 age-file-spec>...]
1433 Non-interactively checks if updates of the specified packages in
1434 the repository are available. DNF exit code will be 100 when
1435 there are updates available and a list of the updates will be
1436 printed.
1437
1438 dnf [options] repository-packages <repoid> info [--all] [<pack‐
1439 age-file-spec>...]
1440 List all related packages.
1441
1442 dnf [options] repository-packages <repoid> info --installed [<pack‐
1443 age-file-spec>...]
1444 List packages installed from the repository.
1445
1446 dnf [options] repository-packages <repoid> info --available [<pack‐
1447 age-file-spec>...]
1448 List packages available in the repository but not currently
1449 installed on the system.
1450
1451 dnf [options] repository-packages <repoid> info --extras [<pack‐
1452 age-file-specs>...]
1453 List packages installed from the repository that are not avail‐
1454 able in any repository.
1455
1456 dnf [options] repository-packages <repoid> info --obsoletes [<pack‐
1457 age-file-spec>...]
1458 List packages in the repository that obsolete packages installed
1459 on the system.
1460
1461 dnf [options] repository-packages <repoid> info --recent [<pack‐
1462 age-file-spec>...]
1463 List packages recently added into the repository.
1464
1465 dnf [options] repository-packages <repoid> info --upgrades [<pack‐
1466 age-file-spec>...]
1467 List packages in the repository that upgrade packages installed
1468 on the system.
1469
1470 dnf [options] repository-packages <repoid> install [<package-spec>...]
1471 Install all packages in the repository.
1472
1473 dnf [options] repository-packages <repoid> list [--all] [<pack‐
1474 age-file-spec>...]
1475 List all related packages.
1476
1477 dnf [options] repository-packages <repoid> list --installed [<pack‐
1478 age-file-spec>...]
1479 List packages installed from the repository.
1480
1481 dnf [options] repository-packages <repoid> list --available [<pack‐
1482 age-file-spec>...]
1483 List packages available in the repository but not currently
1484 installed on the system.
1485
1486 dnf [options] repository-packages <repoid> list --extras [<pack‐
1487 age-file-spec>...]
1488 List packages installed from the repository that are not avail‐
1489 able in any repository.
1490
1491 dnf [options] repository-packages <repoid> list --obsoletes [<pack‐
1492 age-file-spec>...]
1493 List packages in the repository that obsolete packages installed
1494 on the system.
1495
1496 dnf [options] repository-packages <repoid> list --recent [<pack‐
1497 age-file-spec>...]
1498 List packages recently added into the repository.
1499
1500 dnf [options] repository-packages <repoid> list --upgrades [<pack‐
1501 age-file-spec>...]
1502 List packages in the repository that upgrade packages installed
1503 on the system.
1504
1505 dnf [options] repository-packages <repoid> move-to [<package-spec>...]
1506 Reinstall all those packages that are available in the reposi‐
1507 tory.
1508
1509 dnf [options] repository-packages <repoid> reinstall [<pack‐
1510 age-spec>...]
1511 Run the reinstall-old subcommand. If it fails, run the move-to
1512 subcommand.
1513
1514 dnf [options] repository-packages <repoid> reinstall-old [<pack‐
1515 age-spec>...]
1516 Reinstall all those packages that were installed from the repos‐
1517 itory and simultaneously are available in the repository.
1518
1519 dnf [options] repository-packages <repoid> remove [<package-spec>...]
1520 Remove all packages installed from the repository along with any
1521 packages depending on the packages being removed. If
1522 clean_requirements_on_remove is enabled (the default) also
1523 removes any dependencies that are no longer needed.
1524
1525 dnf [options] repository-packages <repoid> remove-or-distro-sync
1526 [<package-spec>...]
1527 Select all packages installed from the repository. Upgrade,
1528 downgrade or keep those of them that are available in another
1529 repository to match the latest version available there and
1530 remove the others along with any packages depending on the pack‐
1531 ages being removed. If clean_requirements_on_remove is enabled
1532 (the default) also removes any dependencies that are no longer
1533 needed.
1534
1535 dnf [options] repository-packages <repoid> remove-or-reinstall [<pack‐
1536 age-spec>...]
1537 Select all packages installed from the repository. Reinstall
1538 those of them that are available in another repository and
1539 remove the others along with any packages depending on the pack‐
1540 ages being removed. If clean_requirements_on_remove is enabled
1541 (the default) also removes any dependencies that are no longer
1542 needed.
1543
1544 dnf [options] repository-packages <repoid> upgrade [<package-spec>...]
1545 Update all packages to the highest resolvable version available
1546 in the repository.
1547
1548 dnf [options] repository-packages <repoid> upgrade-to <pack‐
1549 age-nevr-specs>...
1550 Update packages to the specified versions that are available in
1551 the repository. Upgrade-to is a deprecated alias for the upgrade
1552 subcommand.
1553
1554 Search Command
1555 dnf [options] search [--all] <keywords>...
1556 Search package metadata for keywords. Keywords are matched as
1557 case-insensitive substrings, globbing is supported. By default
1558 lists packages that match all requested keys (AND operation).
1559 Keys are searched in package names and summaries. If the
1560 "--all" option is used, lists packages that match at least one
1561 of the keys (an OR operation). In addition the keys are
1562 searched in the package descriptions and URLs. The result is
1563 sorted from the most relevant results to the least.
1564
1565 This command by default does not force a sync of expired metadata. See
1566 also Metadata Synchronization.
1567
1568 Shell Command
1569 dnf [options] shell [filename]
1570 Open an interactive shell for conducting multiple commands dur‐
1571 ing a single execution of DNF. These commands can be issued man‐
1572 ually or passed to DNF from a file. The commands are much the
1573 same as the normal DNF command line options. There are a few
1574 additional commands documented below.
1575
1576 config [conf-option] [value]
1577
1578 · Set a configuration option to a requested value. If no
1579 value is given it prints the current value.
1580
1581 repo [list|enable|disable] [repo-id]
1582
1583 · list: list repositories and their status
1584
1585 · enable: enable repository
1586
1587 · disable: disable repository
1588
1589 transaction [list|reset|solve|run]
1590
1591 · list: resolve and list the content of the transaction
1592
1593 · reset: reset the transaction
1594
1595 · run: resolve and run the transaction
1596
1597 Note that all local packages must be used in the first shell
1598 transaction subcommand (e.g. install /tmp/nodejs-1-1.x86_64.rpm
1599 /tmp/acpi-1-1.noarch.rpm) otherwise an error will occur. Any
1600 disable, enable, and reset module operations (e.g. module enable
1601 nodejs) must also be performed before any other shell transac‐
1602 tion subcommand is used.
1603
1604 Swap Command
1605 dnf [options] swap <remove-spec> <install-spec>
1606 Remove spec and install spec in one transaction. Each <spec> can be
1607 either a <package-spec>, which specifies a package directly, or a
1608 @<group-spec>, which specifies an (environment) group which contains
1609 it. Automatic conflict solving is provided in DNF by the --allow‐
1610 erasing option that provides the functionality of the swap command
1611 automatically.
1612
1613 Update Command
1614 dnf [options] update
1615 Deprecated alias for the Upgrade Command.
1616
1617 Updateinfo Command
1618 dnf [options] updateinfo [--summary|--list|--info] [<availability>]
1619 [<spec>...]
1620 Display information about update advisories.
1621
1622 Depending on the output type, DNF displays just counts of advi‐
1623 sory types (omitted or --summary), list of advisories (--list)
1624 or detailed information (--info). When the -v option is used
1625 with --info, the information is even more detailed.
1626
1627 <availability> specifies whether advisories about newer versions
1628 of installed packages (omitted or --available), advisories about
1629 equal and older versions of installed packages (--installed),
1630 advisories about newer versions of those installed packages for
1631 which a newer version is available (--updates) or advisories
1632 about any versions of installed packages (--all) are taken into
1633 account. Most of the time, --available and --updates displays
1634 the same output. The outputs differ only in the cases when an
1635 advisory refers to a newer version but there is no enabled
1636 repository which contains any newer version.
1637
1638 Note, that --available tooks only the latest installed versions
1639 of packages into account. In case of the kernel packages (when
1640 multiple version could be installed simultaneously) also pack‐
1641 ages of the currently running version of kernel are added.
1642
1643 To print only advisories referencing a CVE or a bugzilla use
1644 --with-cve or --with-bz options. When these switches are used
1645 also the output of the --list is altered - the ID of the CVE or
1646 the bugzilla is printed instead of the one of the advisory.
1647
1648 If given and if neither ID, type (bugfix, enhancement, secu‐
1649 rity/sec) nor a package name of an advisory matches <spec>, the
1650 advisory is not taken into account. The matching is case-sensi‐
1651 tive and in the case of advisory IDs and package names, globbing
1652 is supported.
1653
1654 Output of the --summary option is affected by the autocheck_run‐
1655 ning_kernel configuration option.
1656
1657 Update-Minimal Command
1658 dnf [options] update-minimal
1659 Deprecated alias for the Upgrade-Minimal Command.
1660
1661 Upgrade Command
1662 dnf [options] upgrade
1663 Updates each package to the latest version that is both avail‐
1664 able and resolvable.
1665
1666 dnf [options] upgrade <package-spec>...
1667 Updates each specified package to the latest available version.
1668 Updates dependencies as necessary.
1669
1670 dnf [options] upgrade <package-nevr-specs>...
1671 Upgrades packages to the specified versions.
1672
1673 dnf [options] upgrade @<spec>...
1674 Alias for the dnf module update command.
1675
1676 If the main obsoletes configure option is true or the --obsoletes flag
1677 is present, dnf will include package obsoletes in its calculations.
1678 For more information see obsoletes.
1679
1680 See also Configuration Files Replacement Policy.
1681
1682 Upgrade-Minimal Command
1683 dnf [options] upgrade-minimal
1684 Updates each package to the latest available version that pro‐
1685 vides a bugfix, enhancement or a fix for a security issue (secu‐
1686 rity).
1687
1688 dnf [options] upgrade-minimal <package-spec>...
1689 Updates each specified package to the latest available version
1690 that provides a bugfix, enhancement or a fix for security issue
1691 (security). Updates dependencies as necessary.
1692
1693 Update-To Command
1694 dnf [options] update-to <package-nevr-specs>...
1695 Deprecated alias for the Upgrade Command.
1696
1697 Upgrade-To Command
1698 dnf [options] upgrade-to <package-nevr-specs>...
1699 Deprecated alias for the Upgrade Command.
1700
1702 Many commands take a <package-spec> parameter that selects a package
1703 for the operation. The <package-spec> argument is matched against pack‐
1704 age NEVRAs, provides and file provides.
1705
1706 <package-file-spec> is similar to <package-spec>, except provides
1707 matching is not performed. Therefore, <package-file-spec> is matched
1708 only against NEVRAs and file provides.
1709
1710 <package-name-spec> is matched against NEVRAs only.
1711
1712 Globs
1713 Package specification supports the same glob pattern matching that
1714 shell does, in all three above mentioned packages it matches against
1715 (NEVRAs, provides and file provides).
1716
1717 The following patterns are supported:
1718
1719 * Matches any number of characters.
1720
1721 ? Matches any single character.
1722
1723 [] Matches any one of the enclosed characters. A pair of characters
1724 separated by a hyphen denotes a range expression; any character
1725 that falls between those two characters, inclusive, is matched.
1726 If the first character following the [ is a ! or a ^ then any
1727 character not enclosed is matched.
1728
1729 {} Matches any of the comma separated list of enclosed strings.
1730
1731 NEVRA Matching
1732 When matching against NEVRAs, partial matching is supported. DNF tries
1733 to match the spec against the following list of NEVRA forms (in
1734 decreasing order of priority):
1735
1736 · name-[epoch:]version-release.arch
1737
1738 · name.arch
1739
1740 · name
1741
1742 · name-[epoch:]version-release
1743
1744 · name-[epoch:]version
1745
1746 Note that name can in general contain dashes (e.g. pack‐
1747 age-with-dashes).
1748
1749 The first form that matches any packages is used and the remaining
1750 forms are not tried. If none of the forms match any packages, an
1751 attempt is made to match the <package-spec> against full package
1752 NEVRAs. This is only relevant if globs are present in the <pack‐
1753 age-spec>.
1754
1755 <package-spec> matches NEVRAs the same way <package-name-spec> does,
1756 but in case matching NEVRAs fails, it attempts to match against pro‐
1757 vides and file provides of packages as well.
1758
1759 You can specify globs as part of any of the five NEVRA components. You
1760 can also specify a glob pattern to match over multiple NEVRA components
1761 (in other words, to match across the NEVRA separators). In that case,
1762 however, you need to write the spec to match against full package
1763 NEVRAs, as it is not possible to split such spec into NEVRA forms.
1764
1766 Commands accepting the <package-nevr-spec> parameter need not only the
1767 name of the package, but also its version, release and optionally the
1768 architecture. Further, the version part can be preceded by an epoch
1769 when it is relevant (i.e. the epoch is non-zero).
1770
1772 <provide-spec> in command descriptions means the command operates on
1773 packages providing the given spec. This can either be an explicit pro‐
1774 vide, an implicit provide (i.e. name of the package) or a file provide.
1775 The selection is case-sensitive and globbing is supported.
1776
1778 <group-spec> allows one to select (environment) groups a particular
1779 operation should work on. It is a case insensitive string (supporting
1780 globbing characters) that is matched against a group's ID, canonical
1781 name and name translated into the current LC_MESSAGES locale (if possi‐
1782 ble).
1783
1785 <module-spec> allows one to select modules or profiles a particular
1786 operation should work on.
1787
1788 It is in the form of NAME:STREAM:VERSION:CONTEXT:ARCH/PROFILE and sup‐
1789 ported partial forms are the following:
1790
1791 · NAME
1792
1793 · NAME:STREAM
1794
1795 · NAME:STREAM:VERSION
1796
1797 · NAME:STREAM:VERSION:CONTEXT
1798
1799 · all above combinations with ::ARCH (e.g. NAME::ARCH)
1800
1801 · NAME:STREAM:VERSION:CONTEXT:ARCH
1802
1803 · all above combinations with /PROFILE (e.g. NAME/PROFILE)
1804
1805 In case stream is not specified, the enabled or the default stream is
1806 used, in this order. In case profile is not specified, the system
1807 default profile or the 'default' profile is used.
1808
1810 <transaction-spec> can be in one of several forms. If it is an integer,
1811 it specifies a transaction ID. Specifying last is the same as specify‐
1812 ing the ID of the most recent transaction. The last form is last-<off‐
1813 set>, where <offset> is a positive integer. It specifies offset-th
1814 transaction preceding the most recent transaction.
1815
1817 Package filtering filters packages out from the available package set,
1818 making them invisible to most of dnf commands. They cannot be used in a
1819 transaction. Packages can be filtered out by either Exclude Filtering
1820 or Modular Filtering.
1821
1822 Exclude Filtering
1823 Exclude Filtering is a mechanism used by a user or by a DNF plugin to
1824 modify the set of available packages. Exclude Filtering can be modified
1825 by either includepkgs or excludepkgs configuration options in configu‐
1826 ration files. The --disableexcludes command line option can be used to
1827 override excludes from configuration files. In addition to user-config‐
1828 ured excludes, plugins can also extend the set of excluded packages. To
1829 disable excludes from a DNF plugin you can use the --disableplugin com‐
1830 mand line option.
1831
1832 To disable all excludes for e.g. the install command you can use the
1833 following combination of command line options:
1834
1835 dnf --disableexcludes=all --disableplugin="*" install bash
1836
1837 Modular Filtering
1838 Please see the modularity documentation for details on how Modular Fil‐
1839 tering works.
1840
1841 With modularity, only RPM packages from active module streams are
1842 included in the available package set. RPM packages from inactive mod‐
1843 ule streams, as well as non-modular packages with the same name or pro‐
1844 vides as a package from an active module stream, are filtered out. Mod‐
1845 ular filtering is not applied to packages added from the command line,
1846 installed packages, or packages from repositories with module_hot‐
1847 fixes=true in their .repo file.
1848
1849 Disabling of modular filtering is not recommended, because it could
1850 cause the system to get into a broken state. To disable modular filter‐
1851 ing for a particular repository, specify module_hotfixes=true in the
1852 .repo file or use --setopt=<repo_id>.module_hotfixes=true.
1853
1854 To discover the module which contains an excluded package use dnf mod‐
1855 ule provides.
1856
1858 Correct operation of DNF depends on having access to up-to-date data
1859 from all enabled repositories but contacting remote mirrors on every
1860 operation considerably slows it down and costs bandwidth for both the
1861 client and the repository provider. The metadata_expire (see
1862 dnf.conf(5)) repository configuration option is used by DNF to deter‐
1863 mine whether a particular local copy of repository data is due to be
1864 re-synced. It is crucial that the repository providers set the option
1865 well, namely to a value where it is guaranteed that if particular meta‐
1866 data was available in time T on the server, then all packages it refer‐
1867 ences will still be available for download from the server in time T +
1868 metadata_expire.
1869
1870 To further reduce the bandwidth load, some of the commands where having
1871 up-to-date metadata is not critical (e.g. the list command) do not look
1872 at whether a repository is expired and whenever any version of it is
1873 locally available to the user's account, it will be used. For non-root
1874 use, see also the --cacheonly switch. Note that in all situations the
1875 user can force synchronization of all enabled repositories with the
1876 --refresh switch.
1877
1879 The updated packages could replace the old modified configuration files
1880 with the new ones or keep the older files. Neither of the files are
1881 actually replaced. To the conflicting ones RPM gives additional suffix
1882 to the origin name. Which file should maintain the true name after
1883 transaction is not controlled by package manager but is specified by
1884 each package itself, following packaging guideline.
1885
1887 Cache Files
1888 /var/cache/dnf
1889
1890 Main Configuration
1891 /etc/dnf/dnf.conf
1892
1893 Repository
1894 /etc/yum.repos.d/
1895
1897 · dnf.conf(5), DNF Configuration Reference
1898
1899 · dnf-PLUGIN(8) for documentation on DNF plugins.
1900
1901 · dnf.modularity(7), Modularity overview.
1902
1903 · DNF project homepage (‐
1904 https://github.com/rpm-software-management/dnf/)
1905
1906 · How to report a bug (‐
1907 https://github.com/rpm-software-management/dnf/wiki/Bug-Reporting)
1908
1909 · YUM project homepage (http://yum.baseurl.org/)
1910
1912 See AUTHORS in DNF source distribution.
1913
1915 2012-2020, Red Hat, Licensed under GPLv2+
1916
1917
1918
1919
19204.2.21 Apr 08, 2020 DNF(8)