MariaDB for Artifactory

Artifactory supports the popular MariaDB fork of MySQL.

To run Artifactory with MariaDB, create a dedicated MariaDB database instance and configure Artifactory as described in the following sections.

⚠️
Deprecation heads-up
Artifactory Self-Managed support for MariaDB 10.5 and MariaDB 10.6 Community is deprecated.

MariaDB 10.5 reached vendor end of life on June 24, 2025 (Community) and July 16, 2025 (Enterprise).

MariaDB 10.6 Community reached vendor end of life on July 6, 2026.

Upgrade to MariaDB 10.11.x or 11.4.x.

For more information, see Artifactory MariaDB Support.

📘
Supported JDBC Driver Versions
Artifactory supports the MariaDB Java Connector versions 2.1.2 and above.
With JDBC version 2.4.x and above, add the following flag to the connection string:
useMysqlMetadata=true

⚠️
Enable Non-PostgreSQL Database
From Artifactory 7.84, Artifactory installations support only PostgreSQL by default. Artifactory will not start after installation unless you configure the system.yaml file to support your non-PostgreSQL database.

Create the Artifactory MariaDB Database

Create and initialize the MariaDB database using the Artifactory-provided SQL script.

Configure Artifactory to Use MariaDB

Download the JDBC driver and update the database connection settings in system.yaml.

Increase MariaDB Default Packet Size

Increase the max_allowed_packet in MariaDB to prevent errors when storing large build and configuration data.

Tune MariaDB for Artifactory

Optimize MariaDB performance by enabling the InnoDB engine and applying recommended tuning parameters.

Known Issues with MariaDB

Known issues and limitations when using MariaDB with JFrog Artifactory, including JDBC driver compatibility.

Related Topics