> 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-management/automated-mariadb-deployment-and-administration/docker-and-mariadb.md).

# MariaDB Containers

Containers are an OCI standard format for software images and their specified time all bundled up into a single distributable time. They can be used for production, development or testing.

Docker Inc. run a [Docker Official Images](https://docs.docker.com/docker-hub/official_images) program to provide users with an essential base implementation of MariaDB in a container and to exemplify best practices of a container.

The containers are [available on Docker Hub](https://hub.docker.com/_/mariadb) as **docker.io/library/mariadb** though many container runtime implementation will fill in the **docker.io/library** where the host/path isn't specified.

The containers are in a Open Container Initiative format that allows the containers to be interoperable with a number of container runtime implementations. Docker, or more fully Docker Engine, is just one of the many available runtimes.

Many people use MariaDB Docker Official Image containers in CI systems like GitHub Actions, though its possible to use these in production environments like kubernetes.

The MariaDB Server container images are available with a number of tags:

* A full version, like 10.11.5
* A major version like 10.11
* The most recent stable GA version - latest
* The most recent stable LTS version - lts

Versions that aren't stable will be suffixed with **-rc**, or **-alpha** to clearly show their release status, and enables [Renovatebot](https://github.com/grooverdan/mariadb-docker/commit/a9a98d720ddc5afe5c62449bbe737f4780aee0fe) and other that follow [semantic versioning](https://docs.renovatebot.com/modules/versioning/#semantic-versioning) to follow updates.

For a consistent application between testing an production environment using the SHA hash of the image is recommended like **docker.io/library/mariadb\@sha256:29fe5062baf36bae8ec68f21a3dce4f0372dadc185e687624f1252fc49d91c67**. There is a list of mapping and history of tags to SHA hash on the [Docker Library repository](https://github.com/docker-library/repo-info/tree/master/repos/mariadb/remote).

{% columns %}
{% column %}
{% content-ref url="/pages/73XByg5T8axV6x2gIIyz" %}
[Adding Plugins to the MariaDB Docker Official Image](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/adding-plugins-to-the-mariadb-docker-official-image.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Instructions on how to extend the official MariaDB Docker image by installing additional plugins and dependencies using a custom Dockerfile.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/AioIP0HmWyHib2Bv4CMk" %}
[Benefits of Managing MariaDB Containers with Orchestration Software](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/benefits-of-managing-mariadb-containers-with-orchestration-software.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Explains the advantages of using orchestration tools like Kubernetes or Docker Swarm for managing MariaDB containers, including automated failover, scaling, and rolling updates.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/sGa5iXylh0QN5SO5hqrC" %}
[Container Backup and Restoration](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/container-backup-and-restoration.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Complete container backup guide: docker volume create, mariadb-dump --all-databases, mariadb-backup --backup/--prepare/--copy-back operations.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/cHuHLjFx5kBX8KIihhnK" %}
[Container Security](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/container-security-concerns.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Discusses security best practices for running MariaDB in containers, addressing topics like root user privileges, volume permissions, and network isolation.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/8W9KsdccMDr9DSSmH8uk" %}
[Creating a Custom Container Image](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/creating-a-custom-container-image.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Guide to building a custom MariaDB container image to include specific configuration files, scripts, or pre-loaded data.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/lrSy4Bx7xeJkSqYrROeL" %}
[Deploy MariaDB Enterprise Server with Docker](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/deploy-mariadb-enterprise-server-with-docker.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Instructions for deploying MariaDB Enterprise Server using the official enterprise Docker images, including handling license keys and entitlements.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/7SxYAZDqUzsLgpViNlPW" %}
[MariaDB Enterprise Docker Registry for MariaDB Enterprise Server](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/mariadb-enterprise-docker-registry-for-mariadb-enterprise-server.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
How to authenticate with and pull images from the private MariaDB Enterprise Docker Registry.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/ojVHY6t9F9Y84LOrC7d0" %}
[Docker and AWS EC2](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/docker-and-aws-ec2.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Specific considerations and steps for running MariaDB Docker containers on Amazon EC2 instances.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/8qZ8WWcISIl4NjrafITi" %}
[Docker and Google Cloud](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/docker-and-google-cloud.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Guide for deploying MariaDB containers on Google Cloud Platform (GCP) compute resources.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/TNk4t4xOPsQiZG1jwCeQ" %}
[Docker and Microsoft Azure](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/docker-and-microsoft-azure.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Instructions for running MariaDB containers within the Microsoft Azure ecosystem.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/LS14sdj1HUMTHh2CQg1b" %}
[Docker Official Image Frequently Asked Questions](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/docker-official-image-frequently-asked-questions.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Answers to common questions regarding the official MariaDB image, covering versioning, tagging, and default configurations.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/aTjdUjbsSUwbeSmepxdh" %}
[Installing and Using MariaDB via Docker](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/installing-and-using-mariadb-via-docker.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Complete guide to MariaDB in Docker. Complete resource for container deployment, volume management, networking, and environment setup for production use.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/ikaPOZo9ZJHilL3Bq9bM" %}
[MariaDB Container Cheat Sheet](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/mariadb-container-cheat-sheet.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
A concise reference of common Docker commands and environment variables used with MariaDB containers.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/xctoRNFP496KETCxLXhW" %}
[MariaDB Enterprise Server Docker Official Image Environment Variables](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/mariadb-server-docker-official-image-environment-variables.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Complete guide to MariaDB in Docker. Complete resource for container deployment, volume management, networking, and environment setup for production use.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/Yr5dt4WZ1R1cb8S3ff0f" %}
[Setting Up a LAMP Stack with Docker Compose](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/setting-up-a-lamp-stack-with-docker-compose.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Complete LAMP stack Docker Compose: define docker-compose.yml services (web/mariadb), set volumes/env vars (${MARIADB\_VERSION}), docker-compose up/down.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/MQuQTirI3usYu7WmUk6X" %}
[Using Healthcheck](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/using-healthcheck-sh.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Complete healthcheck.sh Docker reference: --connect, --innodb\_initialized, --replication\_\* checks, .my-healthcheck.cnf config, and environment variables.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/YE7MbR49CNlcxM70PcHv" %}
[MariaDB Enterprise Container Image Configuration Reference](/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/mariadb-enterprise-container-image-configuration-reference.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Configuration reference for the official MariaDB Enterprise container images — environment variables, command-line flags, and sidecar patterns for production deployments.
{% endcolumn %}
{% endcolumns %}