A guide to installing MariaDB Enterprise Server on various operating systems using package managers (YUM, APT, ZYpp) or binary tarballs.
These instructions detail the deployment of MariaDB Enterprise Server in a Single Standalone Server configuration on a range of supported Operating Systems.
These instructions detail how to deploy a single-node row database, which is suited for a transactional or OLTP workload that does not require high availability (HA). This deployment type is generally for non-production use cases, such as for development and testing.
MariaDB Database Products
These instructions detail the deployment of the following MariaDB database products:
MariaDB Enterprise Server Components
These instructions detail the deployment of the following components:
Term Definitions
MariaDB Corporation provides package repositories for YUM (RHEL, CentOS), APT (Debian, Ubuntu), and ZYpp (SLES).
Install via YUM (CentOS, RHEL, Rocky)
Retrieve your Customer Download Token at and substitute for CUSTOMER_DOWNLOAD_TOKEN in the following directions.
Configure the YUM package repository.
Pass the version to install using the --mariadb-server-version flag to mariadb_es_repo_setup. The following directions reference 11.4.
To configure YUM package repositories:
Checksums of the various releases of the mariadb_es_repo_setup script can be found in the section at the bottom of the page. Substitute ${checksum} in the example above with the latest checksum.
Install MariaDB Enterprise Server and package dependencies:
Installation only loads MariaDB Enterprise Server to the system. MariaDB Enterprise Server requires configuration before the database server is ready for use. See .
Install via APT (Debian, Ubuntu)
Retrieve your Customer Download Token at and substitute for CUSTOMER_DOWNLOAD_TOKEN in the following directions.
Configure the APT package repository.
Pass the version to install using the --mariadb-server-version flag to mariadb_es_repo_setup. The following directions reference
To configure APT package repositories:
Checksums of the various releases of the mariadb_es_repo_setup script can be found in the section at the bottom of the page. Substitute ${checksum} in the example above with the latest checksum.
Install MariaDB Enterprise Server and package dependencies:
Installation only loads MariaDB Enterprise Server to the system. MariaDB Enterprise Server requires configuration before the database server is ready for use. See .
Install via ZYpp (SLES)
Retrieve your Customer Download Token at and substitute for CUSTOMER_DOWNLOAD_TOKEN in the following directions.
Configure the ZYpp package repository.
Pass the version to install using the --mariadb-server-version flag to mariadb_es_repo_setup. The following directions reference 11.4.
To configure ZYpp package repositories:
Checksums of the various releases of the mariadb_es_repo_setup script can be found in the section at the bottom of the page. Substitute ${checksum} in the example above with the latest checksum.
Install MariaDB Enterprise Server and package dependencies:
Installation only loads MariaDB Enterprise Server to the system. MariaDB Enterprise Server requires configuration before the database server is ready for use. See .
MariaDB Enterprise Server can be configured in the following ways:
and can be set in a configuration file (such as /etc/my.cnf). MariaDB Enterprise Server must be restarted to apply changes made to the configuration file.
and can be set on the command-line.
If a system variable supports dynamic changes, then it can be set on-the-fly using the statement.
Configuration Files
MariaDB's packages include several bundled configuration files. It is also possible to create custom configuration files.
On RHEL, CentOS, and SLES, MariaDB's packages bundle the following configuration files:
/etc/my.cnf.d/mariadb-enterprise.cnf
And on RHEL, CentOS, and SLES, custom configuration files from the following directories are read by default:
On Debian and Ubuntu, MariaDB's packages bundle the following configuration files:
/etc/mysql/mariadb.conf.d/50-client.cnf
And on Debian and Ubuntu, custom configuration files from the following directories are read by default:
/etc/mysql/mariadb.conf.d/
Configure MariaDB
Determine which system variables and options you need to configure.
Useful system variables and options for MariaDB Enterprise Server include:
Choose a configuration file in which to configure your system variables and options.
It is not recommended to make custom changes to one of the bundled configuration files. Instead, it is recommended to create a custom configuration file in one of the included directories. Configuration files in included directories are read in alphabetical order. If you want your custom configuration file to override the bundled configuration files, then it is a good idea to prefix the custom configuration file's name with a string that will be sorted last, such as z-.
On RHEL, CentOS, and SLES, a good custom configuration file would be: /etc/my.cnf.d/z-custom-my.cnf
On Debian and Ubuntu, a good custom configuration file would be: /etc/mysql/mariadb.conf.d/z-custom-my.cnf
Set your system variables and options in the configuration file.
They need to be set in a group that will be read by , such as [mariadb] or [server].
For example:
Start the Server
MariaDB Enterprise Server includes configuration to start, stop, restart, enable/disable on boot, and check the status of the Server using the operating system default process management system.
For distributions that use systemd (most supported OSes), you can manage the Server process using the systemctl command:
Test MariaDB Enterprise Server
When MariaDB Enterprise Server is up and running on your system, you should test that it is working and there weren't any issues during startup.
Connect to the server using using the root@localhost user account:
This page is: Copyright © 2025 MariaDB. All rights reserved.