Install MariaDB Connector/C

MariaDB Connector/C supports several Linux distributions and Microsoft Windows.

Configure Package Repository (Linux)

To install MariaDB Connector/C on Linux using APT, YUM, or ZYpp, you must configure your system to use either the ES Package Repository or the CS Package Repository.

If your system is already configured to use one of these package repositories, you can skip to install MariaDB Connector/C.

Choose a package repository to configure:

Package Repository

Description

ES Package Repository

  • MariaDB Enterprise Server package repository

  • Available to customers of MariaDB Corporation

  • Available for APT, YUM, and ZYpp on supported Linux distributions

  • Configured with the mariadb_es_repo_setup utility

CS Package Repository

  • MariaDB Community Server package repository

  • Publicly available

  • Available for APT, YUM, and ZYpp on supported Linux distributions

  • Configured with the mariadb_repo_setup utility

ES Package Repository

MariaDB Connector/C is available from the same package repository as MariaDB Enterprise Server.

To configure the ES package repository:

  1. Install wget.

    Install on Debian/Ubuntu (via APT):

    $ sudo apt install wget
    

    Install on CentOS/RHEL (via YUM):

    $ sudo yum install wget
    

    Install on SLES (via ZYpp):

    $ sudo zypper install wget
    
  2. Download the mariadb_es_repo_setup utility, validate its checksum, and ensure that its permissions allow it to be executed:

    $ wget https://dlm.mariadb.com/enterprise-release-helpers/mariadb_es_repo_setup
    
    $ echo "4f266ff758fe15eeb9b8b448a003eb53e93f3064baf1acb789dd39de4f534b1d  mariadb_es_repo_setup" \
        | sha256sum -c -
    
    $ chmod +x mariadb_es_repo_setup
    
  3. Retrieve your Customer Download Token at https://customers.mariadb.com/downloads/token/ and substitute your token for CUSTOMER_DOWNLOAD_TOKEN in the following step.

  4. Configure the ES package repository using the mariadb_es_repo_setup utility:

    $ sudo ./mariadb_es_repo_setup --token="CUSTOMER_DOWNLOAD_TOKEN" --apply \
       --mariadb-server-version="10.6"
    
    • All major releases of ES contain the same version of MariaDB Connector/C.

    • By default, the mariadb_es_repo_setup utility will configure your system to use the package repository for ES 10.6.

    • To configure your system to use the ES package repository for a specific major release, use the --mariadb-server-version option.

  5. Install MariaDB Connector/C using the package repository.

CS Package Repository

MariaDB Connector/C is available from the same package repository as MariaDB Community Server.

To configure the CS package repository:

  1. Install wget.

    Install on Debian/Ubuntu (via APT):

    $ sudo apt install wget
    

    Install on CentOS/RHEL (via YUM):

    $ sudo yum install wget
    

    Install on SLES (via ZYpp):

    $ sudo zypper install wget
    
  2. Download the mariadb_repo_setup utility, validate its checksum, and ensure that its permissions allow it to be executed:

    $ wget https://downloads.mariadb.com/MariaDB/mariadb_repo_setup
    
    $ echo "fc84b8954141ed3c59ac7a1adfc8051c93171bae7ba34d7f9aeecd3b148f1527  mariadb_repo_setup" \
        | sha256sum -c -
    
    $ chmod +x mariadb_repo_setup
    
  3. Configure the CS package repository using the mariadb_repo_setup utility:

    $ sudo ./mariadb_repo_setup \
       --mariadb-server-version="mariadb-10.6"
    
    • All major releases of CS contain the same version of MariaDB Connector/C.

    • By default, the mariadb_repo_setup utility will configure your system to use the package repository for CS 10.6.

    • To configure your system to use the CS package repository for a specific major release, use the --mariadb-server-version option.

  4. Install MariaDB Connector/C using the package repository.

Installation via Package Repository (Linux)

On supported Linux distributions, MariaDB Connector/C can be installed using APT, YUM, or ZYpp if the system is configured to use the ES Package Repository or the CS Package Repository.

Install on CentOS/RHEL

To install MariaDB Connector/C on CentOS and RHEL, you can use YUM if you have the ES Package Repository or CS Package Repository configured.

Install MariaDB Connector/C and package dependencies:

$ sudo yum install MariaDB-shared MariaDB-devel

Install on Debian/Ubuntu

To install MariaDB Connector/C on Debian and Ubuntu, you can use APT if you have the ES Package Repository or CS Package Repository configured.

Install MariaDB Connector/C and package dependencies:

$ sudo apt install libmariadb3 libmariadb-dev

Install on SLES

To install MariaDB Connector/C on SLES, you can use ZYpp if you have the ES Package Repository or CS Package Repository configured.

Install MariaDB Connector/C and package dependencies:

$ sudo zypper install MariaDB-shared MariaDB-devel

Install via Binary Tarball (Linux)

MariaDB Connector/C can be installed on supported Linux distributions via a binary tarball package:

  1. Go to the MariaDB Connector/C download page

  2. Ensure the "Product" drop-down reads "C connector".

  3. In the "Version" drop-down, select the version you want to download.

  4. In the "OS" drop-down, select your Linux distribution.

  5. Click on the "Download" button to download the binary tarball package.

Install via MSI (Windows)

MariaDB Connector/C can be installed on Microsoft Windows via an MSI package:

  1. Go to the MariaDB Connector/C download page

  2. Ensure the "Product" drop-down reads "C connector".

  3. In the "Version" drop-down, select the version you want to download.

  4. In the "OS" drop-down, select either "MS Windows (64-bit)" or "MS Windows (32-bit)", depending on whether you need a 64-bit or 32-bit connector.

  5. Click on the "Download" button to download the MSI package.

  6. When the MSI package finishes downloading, run it and follow the on-screen instructions.