> For the complete documentation index, see [llms.txt](https://mariadb.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mariadb.com/docs/server/server-usage/storage-engines/tidesql/tidesql-versions-and-compatibility.md).

# TideSQL Versions and Compatibility

How TideSQL major versions map to the TidesDB library, and which MariaDB Server versions each TideSQL release is built against and tested with.

TideSQL is a storage engine plugin built on the TidesDB library, and it is compiled against a specific MariaDB Server. Three version lines therefore matter when you deploy it. They are the TideSQL plugin version, the TidesDB library version it links, and the MariaDB Server version it is built for.

## TideSQL Versions and the TidesDB Library

A TideSQL major version pairs with a single TidesDB library major version. A minor or patch release within a major line links a newer library release of the same major and extends the same manual, so only a new TideSQL major opens a new manual and moves to a new library major.

| TideSQL version  | TidesDB library | Status   |
| ---------------- | --------------- | -------- |
| 5.x              | v10.x           | Current  |
| Earlier releases | Pre-v10 TidesDB | Archived |

This manual documents the TideSQL 5.x line, which links TidesDB v10. The current pinned release is 5.2.0, whose version is encoded as the hex value `0x50200`, and it links TidesDB v10.2.1. It builds against TidesDB v10.2.0 or later, which added the transaction and iterator expiry reads it uses. TideSQL 5.1.1 paired with TidesDB v10.1.1, and 5.1.0 with v10.1.0.

TideSQL 5.2.0 still writes on-disk format 10, the same as 5.0.0, which opened the v10 line, so a database moves between any 5.x releases in either direction without a dump. For the exact rules that relate the plugin version to the library version and the on-disk format, see [Versioning](https://github.com/tidesdb/tidesql/blob/master/VERSIONING.md).

## MariaDB Server Compatibility

Because TideSQL tracks the server's storage-engine interface, a given TideSQL release targets specific MariaDB Server versions. The table below records the versions that have been tested and confirmed working. Full support means the engine has been tested against all known functionality on that server version.

| MariaDB version | Minimum TideSQL version | Full support |
| --------------- | ----------------------- | :----------: |
| 10.x.x          | –                       |      No      |
| 11.4.10         | 3.4.0                   |      Yes     |
| 11.8.6          | 4.0.0                   |      Yes     |
| 12.2.2          | 1.0.0                   |      Yes     |
| 12.3.1          | 4.2.6                   |      Yes     |
| 13.0.2          | 4.5.4                   |      Yes     |

The table is updated as new server versions are tested and confirmed working.

{% hint style="info" %}
TideSQL 5.x targets the MariaDB 13 line. When the `install.sh` builder is run without a `--mariadb-version`, it builds against the latest MariaDB release, falling back to `mariadb-13.0.1` when it cannot look that up. Without a `--tidesdb-version`, it builds the latest TidesDB release, falling back to `v10.2.1`, the release TideSQL 5.2.0 pins.
{% endhint %}

## Installation

TideSQL is a shared-object plugin that must be built against a matching MariaDB Server and TidesDB library. The repository ships an `install.sh` builder that clones MariaDB, builds it with the plugin against a matching library, and writes a ready-to-run configuration file. See [Getting Started with TideSQL](/docs/server/server-usage/storage-engines/tidesql/getting-started-with-tidesql.md) for the builder, its options, and how to load the plugin.

## Clustering

Beyond standalone and replicated servers, TideSQL participates in Galera clustering through the server's wsrep interface, with engine-level write-set certification and cross-node conflict resolution. See [TideSQL Replication and High Availability](/docs/server/server-usage/storage-engines/tidesql/tidesql-replication-and-ha.md) for what the engine does in a cluster.

<sub>*This page is licensed: GPLv2*</sub>