Deploy with Package Repositories

Overview

MariaDB Corporation provides package repositories, including the MariaDB Enterprise Repository and the MariaDB Community Repository, that can be used to install MariaDB products using the operating system's package manager.

Package repositories provide multiple benefits:

  • Package repositories allow package managers to download and install software packages.

  • YUM repositories distribute RPM (.rpm) files for CentOS, Red Hat Enterprise Linux (RHEL), and Rocky Linux.

  • ZYpp repositories distribute RPM (.rpm) files for SUSE Linux Enterprise Server (SLES).

  • APT repositories distribute DEB (.deb) files for Debian and Ubuntu.

If you want to deploy MariaDB database products without using a package repository, alternative deployment methods are available. Available deployment methods are component-specific.

Use Cases

MariaDB database products can be deployed with package repositories to support use cases, such as:

  • Install software using a package manager after configuring a package repository

  • Automatically install missing dependencies using a package manager

Compatibility

The following MariaDB database products can be deployed using package repositories:

  • MariaDB ColumnStore 5 (included with MariaDB Community Server 10.5)

  • MariaDB ColumnStore 6 (included with MariaDB Community Server 10.6)

  • MariaDB Community Server 10.2

  • MariaDB Community Server 10.3

  • MariaDB Community Server 10.4

  • MariaDB Community Server 10.5 (excluding ColumnStore 5)

  • MariaDB Community Server 10.6 (excluding ColumnStore 6)

  • MariaDB Enterprise ColumnStore 5 (included with MariaDB Enterprise Server 10.5)

  • MariaDB Enterprise ColumnStore 6 (included with MariaDB Enterprise Server 10.6)

  • MariaDB Enterprise Server 10.2

  • MariaDB Enterprise Server 10.3

  • MariaDB Enterprise Server 10.4

  • MariaDB Enterprise Server 10.5

  • MariaDB Enterprise Server 10.6

  • MariaDB MaxScale 2.4

  • MariaDB MaxScale 2.5

  • MariaDB MaxScale 6

  • MariaDB MaxScale 22.08

  • MariaDB MaxScale 2.4

  • MariaDB MaxScale 2.5

  • MariaDB MaxScale 6

  • MariaDB MaxScale 22.08

Operating System Package Managers

The package manager depends on the operating system:

Operating System

Package Manager

CentOS 7

YUM

Debian 9

APT

Debian 10

APT

Debian 11

APT

Red Hat Enterprise Linux 7 (RHEL 7)

YUM

Red Hat Enterprise Linux 8 (RHEL 8)

YUM

Rocky Linux 8

YUM

SUSE Linux Enterprise Server 12 (SLES 12)

ZYpp

SUSE Linux Enterprise Server 15 (SLES 15)

ZYpp

Ubuntu 18.04 LTS (Bionic Beaver)

APT

Ubuntu 20.04 LTS (Focal Fossa)

APT

Configure MariaDB Repository

MariaDB Corporation offers multiple repositories. The MariaDB Enterprise Repository is available to customers of MariaDB Corporation. The MariaDB Community Repository is publicly available.

Configure MariaDB Enterprise Repository

MariaDB Corporation provides the MariaDB Enterprise Repository for customers of MariaDB Corporation to install MariaDB database products using the operating system's package manager.

The MariaDB Enterprise Repository is configured using the mariadb_es_repo_setup script, which requires the Customer Download Token to be provided via the --token option.

Configure the MariaDB Enterprise Repository using the following procedure:

  1. Retrieve your Customer Download Token.

  2. Install the prerequisites for downloading the software from the Web.

    Install on CentOS / RHEL / Rocky Linux (YUM):

    $ sudo yum install curl
    

    Install on Debian / Ubuntu (APT):

    $ sudo apt install curl apt-transport-https
    

    Install on SLES (ZYpp):

    $ sudo zypper install curl
    
  3. Configure the MariaDB Enterprise Repository using the mariadb_es_repo_setup script and provide the Customer Download Token using the --token option:

    $ curl -LsSO https://dlm.mariadb.com/enterprise-release-helpers/mariadb_es_repo_setup
    
    $ echo "97e5ef25b4c4a4bd70b30da46b1eae0b57db2f755ef820a28d254e902ab5a879  mariadb_es_repo_setup" \
           | sha256sum -c -
    
    $ chmod +x mariadb_es_repo_setup
    
    $ sudo ./mariadb_es_repo_setup --token="CUSTOMER_DOWNLOAD_TOKEN" --apply
    

    To learn how to configure your system to install a specific product or version from the MariaDB Enterprise Repository, see the available mariadb_es_repo_setup command-line options.

Configure MariaDB Community Repository

MariaDB Corporation provides the MariaDB Community Repository for any MariaDB user to install MariaDB products using the operating system's package manager.

The MariaDB Community Repository is configured using the mariadb_repo_setup script.

Configure the MariaDB Community Repository using the following procedure:

  1. Install the prerequisites for downloading the software from the Web.

    Install on CentOS / RHEL / Rocky Linux (YUM):

    $ sudo yum install curl
    

    Install on Debian / Ubuntu (APT):

    $ sudo apt install curl apt-transport-https
    

    Install on SLES (ZYpp):

    $ sudo zypper install curl
    
  2. Configure the MariaDB Community Repository using the mariadb_repo_setup script:

    $ curl -LsSO https://r.mariadb.com/downloads/mariadb_repo_setup
    
    $ echo "6083ef1974d11f49d42ae668fb9d513f7dc2c6276ffa47caed488c4b47268593  mariadb_repo_setup" \
           | sha256sum -c -
    
    $ chmod +x mariadb_repo_setup
    
    $ sudo ./mariadb_repo_setup
    

    To learn how to configure your system to install a specific product or version from the MariaDB Community Repository, see the available mariadb_repo_setup command-line options.

Installation from Repository

MariaDB products can be installed from the MariaDB Enterprise Repository and the MariaDB Community Repository.

Procedures are provided to deploy MariaDB products from the repositories.