Docker Image

The Docker image comes with ClusterControl installed and configured with all of its components, so you can immediately use it to manage and monitor your existing databases.

Having a Docker image for ClusterControl at the moment is convenient in terms of how quickly it is to get it up and running and it’s 100% reproducible. Docker users can now start testing ClusterControl since we have the Docker image that everyone can pull down from Docker Hub and then launch the tool.

It is a start and our plan is to add better integration with the Docker API in future releases in order to transparently manage Docker containers/images within ClusterControl, e.g., to launch/manage and deploy database clusters using Docker images.

Build the Image

The Dockerfiles are available from our Github repository. You can build it manually by cloning the repository:

$ git clone https://github.com/severalnines/docker
$ cd docker/
$ docker build -t severalnines/clustercontrol .

Running the Container

Please refer to the Docker Hub page for the latest instructions. Use the docker pull command to download the image:

$ docker pull severalnines/clustercontrol

Use the following command to run:

$ docker run -d --name clustercontrol \
-p 5000:80 \
severalnines/clustercontrol

Once started, ClusterControl is accessible at http://Docker_host:5000/clustercontrol. You should see the welcome page to create a default admin user. Use your email address and specify passwords for that user. By default MySQL users root and cmon will be using password and cmon as the default password respectively. You can override this value with -e flag, as in the example below:

$ docker run -d --name clustercontrol \
-e CMON_PASSWORD=MyCM0n22 \
-e MYSQL_ROOT_PASSWORD=SuP3rMan \
-p 5000:80 \
severalnines/clustercontrol

Optionally, you can map the HTTPS port using -p by appending the forwarding as below:

$ docker run -d --name clustercontrol \
-p 5000:80 \
-p 5443:443 \
severalnines/clustercontrol

Verify the container is running by using the ps command:

$ docker ps

For more examples on deployments with Docker images, please refer to ClusterControl on Docker and the Docker image Github page. For more info on the configuration options, please refer to ClusterControl’s Docker Hub page.