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 default admin user by specifying a username (the username “admin” is reserved) and a password on the welcome page.
The installation script will attempt to automate the following tasks:
- Install and configure a MySQL/MariaDB server (used by ClusterControl to store management and monitoring data).
- Install and configure the ClusterControl packages via the package manager.
- Install ClusterControl dependencies via the package manager.
- Configure Apache and SSL.
- Configure SELinux (Red Hat-based distributions only)
- Configure ClusterControl RPC token.
- Configure ClusterControl Controller (CMON) with minimal configuration options.
- Enable the CMON service on boot and start it up.
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
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.