quick-docs/modules/ROOT/pages/dnf.adoc

[[chap-dnf]]
= Using the DNF software package manager

DNF is a software package manager that installs, updates, and removes packages on Fedora and is the successor to YUM (Yellow-Dog Updater Modified).
DNF makes it easy to maintain packages by automatically checking for dependencies and determines the actions required to install packages.
This method eliminates the need to manually install or update the package, and its dependencies, using the `rpm` command.
DNF is now the default software package management tool in Fedora.

[[sect-usage]]
== Usage

`dnf` can be used exactly as `yum` to search, install or remove packages.

To search the repositories for a package type:

----
# sudo dnf search packagename
----

To install the package:

----
# dnf install packagename
----

To remove a package:

----
# dnf remove packagename
----

Other common DNF commands include:

* `autoremove` - removes packages installed as dependencies that are no longer required by currently installed programs.

* `check-update` - checks for updates, but does not download or install the packages.

* `downgrade` - reverts to the previous version of a package.

* `info` - provides basic information about the package including name, version, release, and description.

* `reinstall` - reinstalls the currently installed package.

* `upgrade` - checks the repositories for newer packages and updates them.

* `exclude` - exclude a package from the transaction.

For more DNF commands refer to the man pages by typing `man dnf` at the command-line, or link:http://dnf.readthedocs.io/en/latest/command_ref.html[DNF Read The Docs]

[[sect-automatic-updates]]
== Automatic Updates

The `dnf-automatic` package is a component that allows automatic download and installation of updates.
It can automatically monitor and report, via e-mail, the availability of updates or send a log about downloaded packages and installed updates.

For more information, refer to the link:http://dnf.readthedocs.org/en/latest/automatic.html[Read the Docs: DNF-Automatic] page.

[[sect-system-upgrades]]
== System Upgrades

The Fedora system can be upgraded directly with DNF, or with the DNF system upgrade plugin.
Refer to the xref:dnf-system-upgrade.adoc[DNF System Upgrade] document for more details.

[[sect-language-support-using-dnf]]
== Language Support Using DNF

DNF can be used to install or remove Language Support.
A detailed description with a list of available languages can be found on link:https://fedoraproject.org/wiki/I18N/Language_Support_Using_Dnf[Language Support Using Dnf] page.

[[sect-plugins]]
== Plugins

The core DNF functionality can be extended with plugins.
There are officially supported https://dnf-plugins-core.readthedocs.io[Core DNF plugins]
and also third-party https://dnf-plugins-extras.readthedocs.io[Extras DNF Plugins].
To install them, run

----
# dnf install dnf-plugins-core-PLUGIN_NAME
----

or

----
# dnf install dnf-plugins-extras-PLUGIN_NAME
----

[[exclude-package]]
== Excluding Packages From Transactions

Sometimes it is useful to ignore specific packages from transactions, such as updates.
One such case, for example, could be when an update includes a regression or a bug.
DNF allows you to exclude a package from the transaction:

* using the command line

----
sudo dnf upgrade --exclude=packagename
----

* using its configuration files

You can add a line to `/etc/dnf/dnf.conf` to exclude packages:

----
excludepkgs=packagename
----

This can also be added to the specific repository configuration files in `/etc/yum.repos.d/`.
https://en.wikipedia.org/wiki/Glob_(programming)[Globs] may be used here to list multiple packages, and each specification must be separated by a comma.
If you have used this configuration, you can disable it in individual DNF commands using using the `--disableexcludes` command line switch.

If you use a GUI update application which does not allow you to specify packages to exclude when they run, this method can be used.

=== Using the DNF Versionlock plugin

You can also use the DNF `versionlock` plugin to limit the packages that are included in a transaction.
It allows you to list what versions of particular packages should be considered in a transaction.
All other versions of the specified packages will be ignored.
The plugin is part of `dnf-plugins-core` package and can be installed using the command below:

----
sudo dnf install 'dnf-command(versionlock)'
----

To lock the currently installed version of a package, use:

----
sudo dnf versionlock add package
----

To remove the version lock, use:

----
sudo dnf versionlock delete package
----

The `list` command can be used to list all locked packages, while the `clear` command will delete all locked entries.

[[sect-references]]
== References

. http://dnf.readthedocs.org/en/latest/command_ref.html[DNF Command Reference]
. https://github.com/rpm-software-management/dnf/wiki[DNF wiki]
. https://dnf-plugins-core.readthedocs.io/en/latest/versionlock.html[DNF VersionLock]