Install ClusterControl in 10-minutes!
Free 30-day Enterprise trial included

Welcome to ClusterControl! You’re just a few steps away from setting up your deployment.

Script Installation Instructions

The installer script is the simplest way to get ClusterControl up and running. Run it on your chosen host, and it will take care of installing all required packages and dependencies.

Offline environments are supported as well. See the Offline Installation guide for more details.

On the ClusterControl server, run the following commands:

wget https://severalnines.com/downloads/cmon/install-cc
chmod +x install-cc

With your install script ready, run the command below. Replace S9S_CMON_PASSWORD and S9S_ROOT_PASSWORD placeholders with your choice password, or remove the environment variables from the command to interactively set the passwords. If you have multiple network interface cards, assign one IP address for the HOST variable in the command using HOST=<ip_address>.

S9S_CMON_PASSWORD=<your_password> S9S_ROOT_PASSWORD=<your_password> HOST=<ip_address> ./install-cc # as root or sudo user

After the installation is complete, open a web browser, navigate to https://<ClusterControl_host>/, and create the first admin user by entering a username (note that “admin” is reserved) and a password on the welcome page. Once you’re in, you can deploy a new database cluster or import an existing one.

The installer script supports a range of environment variables for advanced setup. You can define them using export or by prefixing the install command.

See the list of supported variables and example use cases to tailor your installation.

Other Installation Options

Helm Chart

Deploy ClusterControl on Kubernetes using our official Helm chart.

Ansible Role

Automate installation and configuration using our Ansible playbooks.

Puppet Module

Manage your ClusterControl deployment with the Puppet module.

ClusterControl on Marketplaces

Prefer to launch ClusterControl directly from the cloud? It’s available on these platforms:

DigitalOcean Marketplace
gridscale.io Marketplace
Vultr Marketplace
Linode Marketplace
Google Cloud Platform

System requirements:

Hardward (minimum):
Architecture: x86_64 only
RAM: >2 GB
CPU: >2 cores
Disk space: >40 GB

Supported OS:
Red Hat Enterprise Linux 8.x/9.x
Rocky Linux 8.x/9.x
AlmaLinux 8.x/9.x
Ubuntu 18.04/20.04/22.04/24.04 LTS
Debian 10.x/11.x/12.x
SUSE Linux Enterprise Server 15 SP3/15 SP4

For full details, check our documentation.

Resources

ClusterControl User Guide

Need Help? Contact Support

What operating systems does ClusterControl support?

ClusterControl is supported on Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Ubuntu, Debian, and SUSE Linux Enterprise Server. You can find the specific versions supported and how they map to supported databases here.

Where can I find a full list of installation requirements for ClusterControl?

You can find a full list of hardware, OS, SSH and other requirements here.

Where can I find detailed installation documentation and what if I run into trouble when installing ClusterControl?

When you enter your information on the /get-started page, you will be provided your own unique key, as well as detailed instructions for different installation methods. Check out our Getting Started information here for easy to follow documentation. Additionally, you can always reach out to our expert support engineers here.

I am looking for CCX, where can I register for it?

You can register for CCX here.

Getting started FAQ