MariaDB docker container with easy configuration via environment variables.
Supported tags and respective
This mariadb image is a MySQL compliant database image with configuration through
a collection of environment variables detailed below.
For more documentation on how Outrigger images are constructed and how to work
with them, please see the documentation.
How to use this image
Starting a MariaDB instance:
docker run --name some-mariadb -e MYSQL_PASS=my-secret-pw -d phase2/mariadb
... where some-mariadb is the name you want to assign to your container and
my-secret-pw is the password to be set for the MySQL root user
Customizing Database Behavior
The MariaDB startup configuration is specified in the file
and that file in turn includes any files found in the
directory that end with
.cnf. Settings in files in this directory will augment
and/or override settings in /etc/mysql/my.cnf.
If you want to use a customized MySQL configuration, you can create your
alternative configuration file in a directory on the host machine and then mount
that directory location as
/etc/mysql/my.cnf.d inside the mariadb container.
/my/custom/config-file.cnf is the path and name of your custom
configuration file, you can start your mariadb container like this note that
only the directory path of the custom config file is used in this command):
docker run --name some-mariadb -v /my/custom:/etc/mysql/my.cnf.d -e MYSQL_PASS=my-secret-pw -d outrigger/mariadb
This will start a new container some-mariadb where the MariaDB instance uses the
combined startup settings from /etc/mysql/my.cnf and
/etc/mysql/conf.d/config-file.cnf, with settings from the latter taking
If you add custom configuration in this way, you may invalidate the
environment variables as source of database configuration.
Outrigger images use Environment Variables and confd
to "templatize" a number of Docker environment configurations. These templates are
processed on startup with environment variables passed in via the docker run
command-line or via your docker-compose manifest file. Here are the "tunable"
configurations offered by this image.
admin] This will be the password that is set for the user
named admin. The root user does not have a password and allow local connections only.
app_db] If set, a database with this name will be
created when the database first starts up. This is not set by default.
0] By default the slow query log is disabled.
10] Long query threshold time in seconds.
0] By default do not log queries that do not use an index.
Please email outrigger@phase2technology with security concerns.