Introducing our new CEO Don Johnson - Read More

mariadb/maxscale

Verified Publisher

By MariaDB Corporation

Updated 14 days ago

MariaDB MaxScale - The world's most advanced database proxy.

Image
37

5M+

logo

MariaDB MaxScale Docker image

This Docker image runs MariaDB MaxScale.

Building

Build the image:

make build-image

Running

Pull the latest MaxScale image from docker hub:

docker pull mariadb/maxscale:latest

Run the MaxScale container as "mxs":

docker run -d --name mxs mariadb/maxscale:latest

Configuration

The default configuration for the container is minimal and only enables the REST API.

The REST API by default listens on port 8989. The default user is "admin" with password "mariadb". Accessing it from the docker host requires a port mapping specified on container startup. The example below shows general information via curl.

docker run -d -p 8989:8989 --name mxs mariadb/maxscale:latest
curl -u admin:mariadb http://localhost:8989/v1/maxscale

See MaxScale documentation for more information about the REST API.

Configure via configuration file

Custom configuration can be given in an additional configuration file (e.g. my-maxscale.cnf). The file needs to be mounted into /etc/maxscale.cnf.d/:

docker run -d --name mxs -v $PWD/my-maxscale.cnf:/etc/maxscale.cnf.d/my-maxscale.cnf mariadb/maxscale:latest
Commandline Access

docker exec -it mxs bash

Docker Pull Command

docker pull mariadb/maxscale