ClusterControl Documentation
Use the menu below or the search below to learn everything you need to know about ClusterControl

2. Getting StartedΒΆ

Step #1

Install the latest ClusterControl:

$ wget --no-check-certificate
$ chmod +x install-cc
$ ./install-cc   # as root or sudo user

If you have multiple network interface cards, assign one IP address for HOST variable as per example below:

$ HOST= ./install-cc # as root or sudo user


ClusterControl relies on a MySQL server as a data repository for the clusters it manages and an Apache server for the User Interface. The installation script will always install an Apache server on the host. An existing MySQL server can be used or a new MySQL server install is configured for minimum system requirements. If you have a larger server please make the necessary changes to the my.cnf file and restart the MySQL server after the installation.

If you want to perform a non-interactive installation, you can assign each variable with its value beforehand, similar to example below:

$ S9S_CMON_PASSWORD=cmon S9S_ROOT_PASSWORD=root123 S9S_DB_PORT=3306 HOST= ./install-cc

Step #2

Open your web browser to https://ClusterControl IP address or hostname/clustercontrol and create the default Admin user by entering a valid email address and password.

Step #3

Setup passwordless SSH to all target nodes (ClusterControl and all database nodes). Run following commands on ClusterControl server:

$ ssh-keygen -t rsa # press enter on all prompts
$ ssh-copy-id -i ~/.ssh/id_rsa [ClusterControl IP address]
$ ssh-copy-id -i ~/.ssh/id_rsa [Database nodes IP address] # repeat this to all target database nodes


For cloud infrastructure, you may skip this step since all nodes should have been configured with a keypair. Ensure the keypair exists in ClusterControl node and you are good for the next step.


If you use a non-root user, then it must be in sudoers on all nodes. Read here for details.

Step #4

Deploy a new server/cluster or import an existing database server/cluster into ClusterControl via:

Import Existing Server/Cluster | Deploy Database Cluster | Deploy in the Cloud

Step #5

Start managing and monitor your database instances:

User Guide

Step #6

Follow our blog | Exchange with other users | Contact Severalnines Support | Contact Sales