Installing MariaDB with yum/dnf
Comprehensive guide to installing MariaDB using `yum` or `dnf` on RHEL, CentOS, and Fedora, covering repository configuration, GPG key import, and package installation.
On RHEL, CentOS, Fedora, and other similar Linux RPM based distributions, these provide MariaDB packages. These are supported by those distributions. If you have a particular need for a later version than what is in the distribution, then MariaDB provides repositories for them.
Using repositories rather than installing RPM allows for an ease of update when a new release is made. It is highly recommended to install the relevant RPM packages from MariaDB's
repository using yum or dnf. Centos 7 still uses yum, most others use dnf, and SUSE/openSUSE use zypper.
This page walks you through the simple installation steps using dnf and yum.
Adding the MariaDB YUM repository
We currently have YUM/DNF repositories for the following Linux distributions, and for the versions that are in standard (not extended) support:
Red Hat Enterprise Linux (RHEL)
CentOS
Fedora
openSUSE
SUSE
Using the MariaDB Package Repository Setup Script
If you want to install MariaDB with yum, then you can configure yum to install from MariaDB Corporation's MariaDB Package Repository by using the MariaDB Package Repository setup script.
MariaDB Corporation provides a MariaDB Package Repository for several Linux distributions that use yum to manage packages. This repository contains software packages related to MariaDB Server, including the server itself, clients and utilities, client libraries, plugins, and mariadb-backup. The MariaDB Package Repository setup script automatically configures your system to install packages from the MariaDB Package Repository.
To use the script, execute the following command:
curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bashUsing the MariaDB Repository Configuration Tool
If you want to install MariaDB with yum, then you can configure yum to install from MariaDB Foundation's MariaDB Repository by using the MariaDB Repository Configuration Tool.
The MariaDB Foundation provides a MariaDB repository for several Linux distributions that use yum to manage packages. This repository contains software packages related to MariaDB Server, including the server itself, clients and utilities, client libraries, plugins, and mariadb-backup. The MariaDB Repository Configuration Tool can easily generate the appropriate configuration file to add the repository for your distribution.
Once you have the appropriate repository configuration section for your distribution, add it to a file named MariaDB.repo under /etc/yum.repos.d/.
For example, if you wanted to use the repository to install MariaDB 10.6 on RHEL (any version), then you could use the following yum repository configuration in /etc/yum.repos.d/MariaDB.repo:
The example file above includes a gpgkey line to automatically fetch the
GPG public key that is used to verify the digital signatures of the packages in our repositories. This allows the yum, dnf, and rpm utilities to verify the integrity of the packages that they install.
Pinning the MariaDB Repository to a Specific Minor Release
If you wish to pin the yum repository to a specific minor release, or if you would like to do a yum downgrade to a specific minor release, then you can create a yum repository configuration with a baseurl option set to that specific minor release.
For example, if you wanted to pin your repository to MariaDB 10.8.8 on CentOS 7, then you could use the following yum repository configuration in /etc/yum.repos.d/MariaDB.repo:
To change an existing repository configuration, you may execute the following command:
Updating the MariaDB YUM repository to a New Major Release
MariaDB's yum repository can be updated to a new major release. How this is done depends on how you originally configured the repository.
Updating the Major Release with the MariaDB Package Repository Setup Script
If you configured yum to install from MariaDB Corporation's MariaDB Package Repository by using the MariaDB Package Repository setup script, then you can update the major release that the repository uses by running the script again.
Updating the Major Release with the MariaDB Repository Configuration Tool
If you configured yum to install from MariaDB Foundation's MariaDB Repository by using the MariaDB Repository Configuration Tool, then you can update the major release that the repository uses by updating the yum repository configuration file in-place. For example, if you wanted to change the repository from MariaDB 10.6 to MariaDB 10.11, and if the repository configuration file was at /etc/yum.repos.d/MariaDB.repo, then you could execute the following:
After that, the repository should refer to MariaDB 10.11.
If the yum repository is pinned to a specific minor release, then the above sed command can result in an invalid repository configuration. In that case, the recommended options are:
Edit the
MariaDB.reporepository file manually.Or delete the
MariaDB.reporepository file, and then install the repository of the new version with the more robust MariaDB Package Repository setup script.
The MariaDB GPG Key
See the GPG page for information on the various keys used by MariaDB.
Installing MariaDB Packages with YUM/DNF
After the dnf/yum repository is configured, you can install MariaDB by executing the dnf or yum command. The specific command that you would use would depend on which specific packages that you want to install.
Installing the Most Common Packages
To Install the most common packages, execute the following command:
Installing MariaDB Server
To Install MariaDB Server, execute the following command:
Installing MariaDB Galera Cluster with YUM
The process to install MariaDB Galera Cluster with the MariaDB yum repository is practically the same as installing standard MariaDB Server.
You need to install the galera-4 package to obtain the Galera 4 wsrep provider library.
To install MariaDB Galera Cluster, you could execute the following command:
If you haven't yet imported the MariaDB GPG public key, then yum will prompt you to
import it after it downloads the packages, but before it prompts you to install them.
See MariaDB Galera Cluster for more information on MariaDB Galera Cluster.
Installing MariaDB Clients and Client Libraries with YUM
MariaDB Connector/C has been included as the client library (staticly linked). However, the package name for the client library has not been changed.
To Install the clients and client libraries, execute the following command:
If you want compile your own programs against MariaDB Connector/C, execute the following command:
Installing mariadb-backup with YUM
To install mariadb-backup, execute the following command:
Installing Plugins with YUM
Some plugins may also need to be installed.
For example, to install the cracklib_password_check password validation plugin, execute the following command:
Installing Debug Info Packages with YUM
The MariaDB yum repository also contains debuginfo packages. These package may be needed when debugging a problem.
Installing Debug Info for the Most Common Packages with YUM
To install debuginfo for the most common packages, execute the following command:
All packages have their debuginfo by appending -debuginfo to the package name.
Installing Debug Info for MariaDB Server with YUM
To install debuginfo for MariaDB Server, execute the following command:
Installing Older Versions from the Repository
The MariaDB yum repository contains the last few versions of MariaDB. To show what versions are available, use the following command:
The output shows the available versions. For example:
The MariaDB repository in this example contains MariaDB 12.1.2, 12.0.2, and 11.8.2; and the appstream repository contains MariaDB 10.3.39.
To install an older version of a package instead of the latest version we just need to specify the package name, a dash, and then the version number. And we only need to specify enough of the version number for it to be unique from the other available versions.
However, when installing an older version of a package, if dependencies need to be installed, then it will automatically choose to install the latest versions of those packages, which can sometimes break those dependencies. To ensure that all MariaDB packages are on the same version in this scenario, it is necessary to specify them all.
The MariaDB packages that the MariaDB-server package depend on are: MariaDB-client, MariaDB-shared, and MariaDB-common. Therefore, to install MariaDB 12.0.2 from this yum
repository, we could do the following (putting the version in a variable and each package on its own line so things are cleaner):
For MariaDB Enterprise it is necessary to specify the release part of the version number as well, but with an underscore (_) instead of a dash (-), as that is how dnf/yum see the version number. For example, for MariaDB Enterprise Server 11.8.5-2 you would specify the version as 11.8.5_2. For example:
The rest of the install and setup process is as normal.
After Installation
After the installation is complete, you can start MariaDB with:
If you are using MariaDB Galera Cluster, then keep in mind that the first node will have to be bootstrapped.
This page is licensed: CC BY-SA / Gnu FDL
Last updated
Was this helpful?