From Fedora Project Wiki

Switch distribution default version of MariaDB from 11.8 to 12.3

Summary

MariaDB packages in Fedora use a versioned layout (e.g. mariadb11.8, mariadb12.3), where each version provides versioned sub-packages. One version at a time is designated the "distribution default" and additionally provides unversioned package names (e.g. mariadb-server, mariadb-devel). This change switches the distribution default from MariaDB 11.8 to MariaDB 12.3 in Fedora 45.

Owner

Current status


Change owner status update: [24/07/2026]

  • change implemented in mariadb11.8 and mariadb12.3 packages. New builds reached Rawhide
  • change implemented in all dependent packages (amarok). New build reached Rawhide.
  • Checked ELN configuration web and git - no update needed

Detailed Description

A macro in the MariaDB SPECfiles controls which version provides the unversioned names. Flipping this macro in both mariadb11.8 and mariadb12.3 SPECfiles simultaneously switches the distribution default. Two "distribution default" packages cannot coexist due to file-level Conflicts, so the change must be coordinated.

Comparable switches were done for MySQL in Fedora 43 (8.0 → 8.4) and for MariaDB in Fedora 44 (10.11 → 11.8), both without issues.

Feedback

 

Benefit to Fedora

MariaDB 12.3 is the latest LTS version of MariaDB, released on May 29, 2026. It is maintained until June 2029. The previous default, MariaDB 11.8, reaches community end-of-life in June 2028.

Switching to MariaDB 12.3 ensures that Fedora ships a version with full upstream support throughout its lifecycle, with the latest upstream patches and improvements.

Scope

  • Proposal owners:
    • Switch the macro in both mariadb11.8 and mariadb12.3 SPECfiles
    • Audit all packages that depend on mariadb-devel, libmariadb-devel, or mariadb-server and verify they build and work correctly against MariaDB 12.3
    • File bugs and/or PRs for any packages that need fixes
  • Other developers:
    • Cooperate on fixes if their package needs adjustment for MariaDB 12.3 compatibility
  • Release engineering: N/A (not a System Wide Change)
  • Policies and guidelines: N/A
  • Trademark approval: N/A
  • Alignment with the Fedora Strategy: Fedora leads in the Linux distribution development

Upgrade/compatibility impact

Users upgrading from Fedora 44 (which has MariaDB 11.8 as default) to Fedora 45 will have their MariaDB installation upgraded to 12.3.

Database administrators should follow the standard MariaDB major version upgrade procedure:

  1. Back up all databases before upgrading
  2. Run dnf update
  3. Run mariadb-upgrade after starting the new server

https://mariadb.com/docs/server/server-management/install-and-upgrade-mariadb/upgrading/mariadb-community-server-upgrade-paths/upgrading-from-mariadb-11-8-to-mariadb-12-3

MariaDB 11.8 remains available in Fedora 45 as mariadb11.8-server for users who need more time to migrate.


Note: innodb_snapshot_isolation now defaults to ON in MariaDB 12.3, which changes the semantics of REPEATABLE READ transactions. Applications that depend on the previous behavior should test before upgrading. See https://mariadb.com/docs/release-notes/community-server/12.3/mariadb-12.3-changes-and-improvements

Note: MariaDB 12.3 adds reserved words CONVERSION, ST_COLLECT, and TO_DATE. SQL using these as unquoted identifiers will need quoting.

Note: When upgrading a replica to 12.3, the master_use_gtid setting is reset to DEFAULT (MDEV-39788). Re-apply it after upgrading.

How To Test

Fresh install:

  • dnf install mariadb-server → installs mariadb12.3-server
  • dnf install mariadb11.8-server → installs mariadb11.8-server
  • dnf install mariadb12.3-server → installs mariadb12.3-server
  • Verify the server starts, accepts connections, and runs basic queries

Upgrade scenario:

  • Running dnf update from a Fedora 44 installation with MariaDB 11.8 results in mariadb12.3-server
  • After upgrade, run mariadb-upgrade and verify data integrity

Staying on 11.8 (manual steps):

  1. Disable the service: systemctl disable --now mariadb
  2. Run dnf update (installs 12.3)
  3. Swap back: dnf swap mariadb-server mariadb11.8-server --allowerasing
  4. Restore service: systemctl enable --now mariadb

Conflict test:

  • Installing both mariadb11.8-server and mariadb12.3-server must fail gracefully with a conflict message about mariadb-server-any

User Experience

Users get access to MariaDB 12.3's features and enhancements. The installation and management experience remains identical.

Dependencies

Only a single package in Fedora and RPMFusion needs rebuild:

amarok - BuildRequires: mariadb-embedded-devel [DONE : 06f572e : FEDORA-2026-08f599f1f9]

All other packages depending on MariaDB are built against the client library provided by the mariadb-connector-c package.

Contingency Plan

  • Contingency mechanism: revert the macro change in both SPECfiles to restore MariaDB 11.8 as the default
  • Contingency deadline: N/A (not a System Wide Change)
  • Blocks release? No

Documentation

Release Notes

MariaDB 12.3 is the latest long-term support release, maintained until June 2029. It consolidates all features from the rolling releases 12.0, 12.1, and 12.2 on top of the previous LTS (11.8).

Major changes since MariaDB 11.8: https://mariadb.com/docs/release-notes/community-server/12.3/mariadb-12.3-changes-and-improvements

Retrieved from "https://fedoraproject.org/w/index.php?title=Changes/MariaDB_12.3&oldid=780458"