> 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

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" %}
