Skip to content

MariaDB update KB links and a few other minor changes #2696

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tianon merged 5 commits into from
Aug 31, 2026
Merged

MariaDB update KB links and a few other minor changes #2696

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
881d62b
mariadb: ColumnStore link reduction
grooverdan Aug 31, 2026
6b4fad0
mariadb: update example with more modern verison
grooverdan Aug 31, 2026
02a5939
mariadb: -ti options aren't needed for --help --verbose
grooverdan Aug 31, 2026
e922311
mariadb: --mariadbd is supported in every current version
grooverdan Aug 31, 2026
4ac30f8
mariadb: Knowledge Base was replaced with MariaDB Docs
grooverdan Aug 31, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 20 additions & 21 deletions mariadb/content.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -97,35 +97,35 @@ $ docker run -it --rm %%IMAGE%% mariadb --host <server container IP> --user exam
That will give you a standard MariaDB prompt. You can test it with:

```console
MariaDB [(none)]> \s
MariaDB [test]> \s
--------------
client/mariadb Ver 15.1 Distrib 10.6.16-MariaDB, for Linux (x86_64) using EditLine wrapper
mariadb from 12.3.3-MariaDB, client 15.2 for debian-linux-gnu (x86_64) using EditLine wrapper

Connection id: 20
Connection id: 5
Current database: test
Current user: example-user@bark
SSL: Not in use
Current user: example-user@10.89.0.5
SSL: Cipher in use is TLS_AES_256_GCM_SHA384, cert is OK
Current pager: stdout
Using outfile: ''
Using delimiter: ;
Server: MariaDB
Server version: 10.6.16-MariaDB Source distribution
Server version: 12.3.3-MariaDB-ubu2404 mariadb.org binary distribution
Protocol version: 10
Connection: 192.168.178.73 via TCP/IP
Server characterset: latin1
Db characterset: latin1
Client characterset: utf8mb3
Conn. characterset: utf8mb3
Connection: m via TCP/IP
Server characterset: utf8mb4
Db characterset: utf8mb4
Client characterset: utf8mb4
Conn. characterset: utf8mb4
TCP port: 3306
Uptime: 6 min 4 sec
Uptime: 3 min 7 sec

Threads: 1 Questions: 32 Slow queries: 0 Opens: 20 Open tables: 13 Queries per second avg: 0.087
Threads: 1 Questions: 12 Slow queries: 0 Opens: 17 Open tables: 10 Queries per second avg: 0.064
--------------
```

... which will give you the version and connection information. You can then use `exit` to leave the MariaDB command line client and the client container.

More information about the MariaDB command-line client can be found in the [MariaDB Knowledge Base : MariaDB Command Line Client](https://mariadb.com/kb/en/mariadb-command-line-client/).
More information about the MariaDB command-line client can be found in the [MariaDB Documentation : MariaDB Command Line Client](https://mariadb.com/docs/server/clients-and-utilities/mariadb-client/mariadb-command-line-client).

## Container shell access

Expand Down Expand Up @@ -165,7 +165,7 @@ These disable the authentication of `user@hostname` users. To re-enable the `ski
To view the resulting configuration of your `%%IMAGE%%` container:

```console
$ docker run --name some-%%REPO%% -v /my/custom:/etc/mysql/conf.d --rm %%IMAGE%%:latest my_print_defaults --mysqld
$ docker run --name some-%%REPO%% -v /my/custom:/etc/mysql/conf.d --rm %%IMAGE%%:latest my_print_defaults --mariadbd
```

### Configuration without a `cnf` file
Expand All @@ -179,7 +179,7 @@ $ docker run --name some-%%REPO%% -e MARIADB_ROOT_PASSWORD=my-secret-pw -d %%IMA
If you would like to see a complete list of available options, just run:

```console
$ docker run -it --rm %%IMAGE%%:latest --verbose --help
$ docker run --rm %%IMAGE%%:latest --verbose --help
```

## Environment Variables
Expand Down Expand Up @@ -232,28 +232,27 @@ If there is no database initialized when the container starts, then a default da

## Health/Liveness/Readiness Checking

See [the "Official Images" FAQ](https://github.com/docker-library/faq#healthcheck) for why there is no default `HEALTHCHECK` directive. However, you can use the `healthcheck.sh` script to choose from a (non-exhaustive) list of tests to check for whatever you consider health/liveness/readiness. Refer to the [MariaDB Knowledge Base : Using Healthcheck.sh](https://mariadb.com/kb/en/using-healthcheck-sh-script/) to learn about how to use it and which exact tests are provided.
See [the "Official Images" FAQ](https://github.com/docker-library/faq#healthcheck) for why there is no default `HEALTHCHECK` directive. However, you can use the `healthcheck.sh` script to choose from a (non-exhaustive) list of tests to check for whatever you consider health/liveness/readiness. Refer to the [MariaDB Documentation : Using Healthcheck.sh](https://mariadb.com/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/using-healthcheck-sh) to learn about how to use it and which exact tests are provided.

## Usage against an existing database

If you start your `%%IMAGE%%` container instance with a data directory that already contains a database (specifically, a `mysql` subdirectory), no environment variables that control initialization will be needed or examined, and no pre-existing databases will be changed. The only exception is the non-default `MARIADB_AUTO_UPGRADE` environment variable, that might cause `mysql_upgrade`/`mariadb-upgrade` to run, which might change the system tables.

## Backups and Restores

Backing up and restoring databases is important in containers too. The documentation on how to do this can be found on the [MariaDB Knowledge Base : Container Backup and Restoration](https://mariadb.com/kb/en/backups-and-restoration/).
Backing up and restoring databases is important in containers too. The documentation on how to do this can be found on the [MariaDB Documentation : Container Backup and Restoration](https://mariadb.com/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/container-backup-and-restoration).

## Frequently Asked Questions / How to reset root and user passwords

This is documented on [MariaDB Knowledge Base : Frequenty Asked Questions of Docker Official Image](https://mariadb.com/kb/en/frequenty-asked-questions-of-docker-official-image/#how-to-reset-passwords).
This is documented on [MariaDB Documentation : Frequenty Asked Questions of Docker Official Image](https://mariadb.com/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/docker-official-image-frequently-asked-questions#how-to-reset-passwords).

## How to install MariaDB plugins

This is documented on [MariaDB Knowledge Base : Adding Plugins to the Docker Official Image](https://mariadb.com/kb/en/adding-plugins-to-the-mariadb-docker-official-image/).
This is documented on [MariaDB Documentation : Adding Plugins to the Docker Official Image](https://mariadb.com/docs/server/server-management/automated-mariadb-deployment-and-administration/docker-and-mariadb/adding-plugins-to-the-mariadb-docker-official-image).

# Related Images

- [MariaDB MaxScale](https://hub.docker.com/r/mariadb/maxscale/tags)
- [MariaDB ColumnStore](https://hub.docker.com/r/mariadb/columnstore/tags)

# Compose File Examples

Expand Down