> For the complete documentation index, see [llms.txt](https://mariadb.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mariadb.com/docs/server/server-management/install-and-upgrade-mariadb/installing-mariadb/binary-packages/rpm/troubleshooting-mariadb-installs-on-rhel-centos.md).

# Troubleshooting MariaDB Installs on RHEL / CentOS

Solutions for common installation issues on RHEL and CentOS, such as conflicts with existing MySQL installations and handling configuration file backups (.rpmsave).

The following article is about different issues people have encountered when installing MariaDB on RHEL / CentOS.

It is highly recommended to [install with yum](/docs/server/server-management/install-and-upgrade-mariadb/installing-mariadb/binary-packages/rpm/yum.md) where possible.

In RHEL/ CentOS it is also possible to install a [RPM](https://downloads.askmonty.org/mariadb/) or a [tar ball](/docs/server/server-management/install-and-upgrade-mariadb/installing-mariadb/binary-packages/installing-mariadb-binary-tarballs.md). The RPM is the preferred version, except if you want to install many versions of MariaDB or install MariaDB in a non standard location.

### Replacing MySQL

If you removed an MySQL RPM to install MariaDB, note that the MySQL RPM on uninstall renames `/etc/my.cnf` to `/etc/my.cnf.rpmsave.`

After installing MariaDB you should do the following to restore your configuration options:

```bash
mv /etc/my.cnf.rpmsave /etc/my.cnf
```

### Unsupported configuration options

If you are using any of the following options in your `/etc/my.cnf` or other `my.cnf` file you should remove them. This is also true for MySQL 5.1 or newer:

```ini
skip-bdb
```

## See also

* [Installing with yum (recommended)](/docs/server/server-management/install-and-upgrade-mariadb/installing-mariadb/binary-packages/rpm/yum.md)
* [Installing MariaDB RPM Files](/docs/server/server-management/install-and-upgrade-mariadb/installing-mariadb/binary-packages/rpm.md)
* [Checking MariaDB RPM Package Signatures](/docs/server/server-management/install-and-upgrade-mariadb/installing-mariadb/binary-packages/rpm/checking-mariadb-rpm-package-signatures.md)

<sub>*This page is licensed: CC BY-SA / Gnu FDL*</sub>

{% @marketo/form formId="4316" %}
