Welcome to the Cloudbreak 2.4.1 documentation!

Cloudbreak simplifies the provisioning, management, and monitoring of on-demand HDP clusters in virtual and cloud environments. It leverages cloud infrastructure to create host instances, and uses Apache Ambari via Ambari blueprints to provision and manage HDP clusters.

Cloudbreak allows you to create clusters using the Cloudbreak web UI, Cloudbreak CLI, and Cloudbreak REST API. Clusters can be launched on public cloud infrastructure platforms Microsoft Azure, Amazon Web Services (AWS), and Google Cloud Platform (GCP), and on the private cloud infrastructure platform OpenStack.

Primary Use Cases

Cloudbreak allows you to create, manage, and monitor your clusters on your chosen cloud platform:


Refer to Architecture.

Get Started

To get started with Cloudbreak:

  1. Select the cloud platform on which you would like to launch Cloudbreak.
  2. Select the deployment option that you would like to use.
  3. Launch Cloudbreak.

Select Cloud Platform

You can deploy and use Cloudbreak on the following cloud platforms:

Select Deployment Option

There are two basic deployment options:

Deployment option When to use
Instantiate one of the pre-built cloud images

This is the recommended basic deployment option.

The cloud images include Cloudbreak deployer pre-installed on a CentOS VM.

Install the Cloudbreak deployer on your own VM

This is an advanced deployment option.

Select this option if you have custom VM requirements. The supported operating systems are RHEL, CentOS, and Oracle Linux 7 (64-bit).

Launch Cloudbreak

(Option 1) You can launch Cloudbreak from one of the pre-built images:

(Option 2) Or you can launch Cloudbreak on your own VM on one of these cloud platforms. This is an advanced deployment option that you should only use if you have custom VM requirements.

In general, the steps include meeting the prerequisites, launching Cloudbreak on a VM, and creating the Cloudbreak credential. After performing these steps, you can create a cluster based on one of the default blueprints or upload your own blueprint and then create a cluster.


The Cloudbreak software runs in your cloud environment. You are responsible for cloud infrastructure related charges while running Cloudbreak and the clusters being managed by Cloudbreak.