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 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 "cfcd35671125d657a212d92b93be7b1f4ad2fda58dfa8b5ab4b601bf3afa4eae  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 "d4e4635eeb79b0e96483bd70703209c63da55a236eadd7397f769ee434d92ca8  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" 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.