Install MariaDB Connector/C

Overview

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 curl.

    Install via APT on Debian, Ubuntu:

    $ sudo apt install curl
    

    Install via YUM on CentOS, RHEL, Rocky Linux:

    $ sudo yum install curl
    

    Install via ZYpp on SLES:

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

    $ 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
    
  3. Retrieve your Customer Download Token at Customer Download Token at the MariaDB Customer Portal 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 curl.

    Install via APT on Debian, Ubuntu:

    $ sudo apt install curl
    

    Install via YUM on CentOS, RHEL, Rocky Linux:

    $ sudo yum install curl
    

    Install via ZYpp on SLES:

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

    $ curl -LsSO https://r.mariadb.com/downloads/mariadb_repo_setup
    
    $ echo "6083ef1974d11f49d42ae668fb9d513f7dc2c6276ffa47caed488c4b47268593  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, Rocky Linux

To install MariaDB Connector/C on CentOS, RHEL, and Rocky Linux, 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" dropdown reads "C connector."

  3. In the "Version" dropdown, select the version you want to download.

  4. In the "OS" dropdown, 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" dropdown reads "C connector."

  3. In the "Version" dropdown, select the version you want to download.

  4. In the "OS" dropdown, 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.