readystack/mariadb repository overview

⁠MariaDB

readystack/mariadb:12.3.3-CE-ubuntu24.04-r4

Source, recipe and records

• Source and build recipe: https://readystack.dev/products/mariadb/recipe⁠
• Upstream source at this release's pinned commit (mariadb-12.3.3): https://github.com/MariaDB/server/tree/83e909fc2a0dbc394b4b683fb3fa2d7dcf26cc5e⁠
• Product page: https://readystack.dev/products/mariadb⁠
• Hermetic Build Kit for this release (free with an account): https://readystack.dev/products/mariadb⁠
• Release history (JSON): https://readystack.dev/api/releases/mariadb⁠
• Defect record: https://readystack.dev/defects.html?product=mariadb⁠
• Today's scan: https://readystack.dev/products/mariadb#pp-grade⁠
• Report an issue: https://github.com/ReadyStackFree/readystack/issues/new?template=bug.yml&product=mariadb⁠
• Signing key (cosign): https://readystack.dev/keys/cosign.pub⁠

A cosign-signed build of github.com/MariaDB/server tag mariadb-12.3.3 (MariaDB Server 12.3.3, a release of the 12.3 LTS series; server GPL-2.0, client library LGPL-2.1 or later), built clean-room from official upstream source by ReadyStack⁠.

⁠Who uses it and why

Who: Developers and database administrators who need a relational SQL database for websites and business applications.

Why: MariaDB Server is an open-source relational database with an SQL interface, pluggable storage engines, replication and clustering, and JSON, GIS and vector search features.

Use case: A web application keeps its customers, orders and content in MariaDB. A replica on a second server receives every change, so reports can run there without slowing the main database, and a current copy of the data is ready if the primary server fails.

About the upstream project, written from its own description: https://github.com/MariaDB/server⁠ · https://mariadb.org/about/⁠

⁠What you get

Signature, user and attestations below were measured on the published digest sha256:46214d6c22dbd6c86c151f0a6aab629bd09857f4f5fac42c30084d6d562db1a6 on 2026-11-05.

• Scan scores — we scan every image we publish every day (an SBOM made with syft, vulnerabilities matched with grype, scored with cerodeo-v1, the rubric ce.rodeo published until 2026-10-26) and record each scan with how its score was derived. This release's first and latest scan: https://readystack.dev/products/mariadb⁠
• ReadyStack release check — passed at release on 2026-11-05: no fixable critical or high vulnerability (Docker Scout and OSV), a non-root user, SBOM and provenance attached. This is ReadyStack's own test, not a Docker grade; vulnerabilities published since then are in today's result at https://readystack.dev/queue⁠.
• Signed — cosign signature by the ReadyStack release key (fingerprint 04daa92344a52dbc) on this release's index digest sha256:46214d6c22dbd6c86c151f0a6aab629bd09857f4f5fac42c30084d6d562db1a6; verify with cosign verify --key https://readystack.dev/keys/cosign.pub readystack/mariadb:12.3.3-CE-ubuntu24.04-r4.
• Attestations — An SPDX SBOM and SLSA v1 build provenance are attached to this digest.
• Runs as a non-root user (mysql).
• Built from source by ReadyStack.

⁠Which tag should I pull?

This image follows the ReadyStack release-tag convention:

• The current release is 12.3.3-CE-ubuntu24.04-r4 — the release listed at readystack.dev. Release tags use the pattern <upstream-version>-CE-<base-os>-r<N>; the current one is signed, attested (SBOM + provenance), and is provided under the ReadyStack Agreement⁠.

• Earlier release tags (an older version or revision in the same pattern) are superseded. They stay pullable so existing deployments can pin them, but they are no longer re-graded, and fixes appear only in newer releases: move to the current release. For a superseded release's build kit, ask support.

• Release tags never move, so pulling the same tag again never changes the image. To be offered each new release automatically (a new revision r<N+1>, or a new upstream version), use the ReadyStack Renovate preset: https://readystack.dev/updates.html⁠

• Any tag beginning with internal- is an engineering-pipeline artifact published for build observability. It is unsupported, may change or disappear without notice, and must not be used in production.

# ✓ current release
docker pull readystack/mariadb:12.3.3-CE-ubuntu24.04-r4

# ✗ unsupported (do not pull)
docker pull readystack/mariadb:internal-...

This release is signed; verify it with cosign verify --key https://readystack.dev/keys/cosign.pub readystack/mariadb:12.3.3-CE-ubuntu24.04-r4 (the signature is recorded in the public Sigstore transparency log). Support: [email protected]⁠, as set out in the ReadyStack Agreement⁠.

⁠Deployment

Single container. MariaDB Server 12.3.3 (12.3 LTS) compiled from the upstream source tag with CMake and installed in /usr/local/mariadb. The image is the whole database server: there is no external database and no sidecar, and Galera clustering is not compiled in. mariadbd runs in the foreground as the non-root mysql user. On the first start, when the data directory has no mysql subdirectory the entrypoint creates the data directory in /var/lib/mysql and sets the root password before the server opens a network port.

Secrets go in an env file that only you can read, not on the command line, and passwords that only set up the first start come out of it after setup. Create mariadb.env with install -m 600 /dev/null mariadb.env, then write these lines into it with an editor, with your own values (a value typed into a shell stays in its history). Docker reads each line as written: no quotes around a value, no spaces around =.

# First start only: MARIADB_ROOT_PASSWORD sets root's password when the first start initialises an empty data directory. Remove this line after setup and recreate the container; root keeps the password.
MARIADB_ROOT_PASSWORD=YOUR_ROOT_PASSWORD

docker run -d --name mariadb --env-file ./mariadb.env -p 3306:3306 -v mariadb-data:/var/lib/mysql readystack/mariadb:12.3.3-CE-ubuntu24.04-r4

Replace YOUR_ROOT_PASSWORD in mariadb.env with a password of at least 8 characters. On a data directory with no mysql subdirectory the image refuses to start without one, and refuses the placeholder itself. The MYSQL_* variable names used by the official images (MYSQL_ROOT_PASSWORD, MYSQL_DATABASE, MYSQL_USER, MYSQL_PASSWORD) are accepted as aliases. Once the first start has initialised the data directory, remove the MARIADB_ROOT_PASSWORD line from mariadb.env and recreate the container on the same volume (docker rm -f mariadb, then the docker run command again): the server starts, root keeps its password, and the password is no longer in the container's environment (tested).

⁠The full ReadyStack Hermetic Build Kit

The complete --network=none build kit for this image — plus admin/DB/API handbooks, the build's validation records, and its build provenance records — is a free download for any registered account at readystack.dev/products/mariadb⁠. A clean-room rebuild from this release's archive on an egress-blocked host reproduced its linux/amd64 digest sha256:ce6df3f1fa1e14f5226d41f59d61b86c1656563e8a879f28cd78831625ee56cd on 2026-11-05.

⁠Trademarks

This image contains MariaDB®.

MariaDB® is a registered trademark of MariaDB plc.

ReadyStack is not affiliated with or endorsed by MariaDB plc.

The name identifies the software in this image; it is built from github.com/MariaDB/server source at mariadb-12.3.3 (commit 83e909fc2a0d). ReadyStack does not modify its source.

ReadyStack uses no project logos.

Trademark policy: https://mariadb.com/trademarks/⁠ (read 2026-11-04).

— ReadyStack · readystack.dev