Install Cloudbreak Deployer

Follow these steps to install Cloudbreak Deployer on your operating system.

The instructions below are for CentOS. If you are using a differnt OS, perform equivalent steps.

System Requirements

To run the Cloudbreak Deployer and install the Cloudbreak application, your system must meet the following requirements:

You can install Cloudbreak on Mac OS X for evaluation purposes only. This operating system is not supported for a production deployment of Cloudbreak.


You must satisfy the following preprequisites before installing the Cloudbreak Deployer.


Make sure that the following ports are open:

Root Access

Execute every command as root. In order to get root privileges execute:

sudo -i

System Updates

Ensure that your system is up-to-date and reboot it if necessary (for example, if there was a kernel update):

yum -y update


Install iptables-services. Without iptables-services installed the 'iptables save' command will not be available:

yum -y install iptables-services net-tools

Then, configure permissive iptables on your machine:

iptables --flush INPUT && \
iptables --flush FORWARD && \
service iptables save

Docker Service

Configure a custom Docker repository for installing the correct version of Docker:

cat > /etc/yum.repos.d/docker.repo <<"EOF"
name=Docker Repository

Next, install the Docker service:

yum install -y docker-engine-1.9.1 docker-engine-selinux-1.9.1
systemctl start docker
systemctl enable docker

Cloudbreak Deployer Installation

Install Cloudbreak Deployer

Install the Cloudbreak Deployer and unzip the platform-specific single binary to your PATH. For example:

cd /var/lib/cloudbreak-deployment/
curl -Ls$(uname)_x86_64.tgz | sudo tar -xz -C /bin cbd
cbd --version

Once the Cloudbreak Deployer is installed, you can set up the Cloudbreak application.

Initialize Your Profile

Initialize cbd by using:

mkdir cloudbreak-deployment
cd cloudbreak-deployment

First, initialize cbd by creating a Profile file with the following content:


By default the cbd tool tries to guess PUBLIC_IP to bind Cloudbreak UI to it. But if cbd cannot get the IP address during the initialization, set the appropriate value also in your Profile.

Generate Your Profile

Generate configurations by executing:

rm *.yml
cbd generate

This creates the following configuration files:

Start Cloudbreak Application

To start the Cloudbreak application, use the following command:

cbd pull
cbd start

This will start all the Docker containers and initialize the Cloudbreak application. It will take a few minutes for all the services to start.

The first time you start the Coudbreak app, the process will take longer than usual due to the download of all the necessary docker images.

After the cbd start command finishes, use this command to check the logs of the Cloudbreak application:

cbd logs cloudbreak

You should see a message like this in the log: Started CloudbreakApplication in 36.823 seconds. Cloudbreak normally takes less than a minute to start.


If you face permission or connection issues, disable SELinux:

  1. Set the SELINUX=disabled in /etc/selinux/config.
  2. Reboot the machine.
  3. Ensure the SELinux is not turned on afterwards:
setenforce 0 && sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config

Next Steps

After you have installed Cloudbreak Deployer, perform cloud provider specific configurations and then provision a cluster. See cloud provider specific steps:

Note: AWS and OpenStack Setup sections contain provider-specific and other additional Profile settings.

Edit on GitHub