Install the Management Server on the First Host

The first step in installation, whether you are installing the Management Server on one host or many, is to install the software on a single node.

Note

If you are planning to install the Management Server on multiple nodes for high availability, do not proceed to the additional nodes yet. That step will come later.

The CloudStack Management server can be installed using either RPM or DEB packages. These packages will depend on everything you need to run the Management server.

Configure package repository

CloudStack is only distributed from source from the official mirrors. However, members of the CloudStack community may build convenience binaries so that users can install Apache CloudStack without needing to build from source.

If you didn’t follow the steps to build your own packages from source in the sections for “Building RPMs from Source” or “Building DEB packages” you may find pre-built DEB and RPM packages for your convenience linked from the downloads page.

Note

These repositories contain both the Management Server and KVM Hypervisor packages.

RPM package repository

There is a RPM package repository for CloudStack so you can easily install on RHEL and SUSE based platforms.

If you’re using an RPM-based system, you’ll want to add the Yum repository so that you can install CloudStack with Yum.

In RHEL or CentOS:

Yum repository information is found under /etc/yum.repos.d. You’ll see several .repo files in this directory, each one denoting a specific repository.

To add the CloudStack repository, create /etc/yum.repos.d/cloudstack.repo and insert the following information.

In the case of RHEL being used, you can replace ‘centos’ by ‘rhel’ in the value of baseurl

[cloudstack]
name=cloudstack
baseurl=http://download.cloudstack.org/centos/$releasever/4.22/
enabled=1
gpgcheck=0

Now you should now be able to install CloudStack using Yum.

In SUSE:

Zypper repository information is found under /etc/zypp/repos.d/. You’ll see several .repo files in this directory, each one denoting a specific repository.

To add the CloudStack repository, create /etc/zypp/repos.d/cloudstack.repo and insert the following information.

[cloudstack]
name=cloudstack
baseurl=http://download.cloudstack.org/suse/4.22/
enabled=1
gpgcheck=0

Now you should now be able to install CloudStack using zypper.

DEB package repository

In Ubuntu:

You can add a DEB package repository to your apt sources with the following commands. Replace the code name with your Ubuntu LTS version : Ubuntu 22.04 (Jammy), and Ubuntu 24.04 (Noble). Ubuntu 12.04 (Precise), Ubuntu 14.04 (Trusty), Ubuntu 16.04 (Xenial), Ubuntu 18.04 (Bionic), and Ubuntu 20.04 (Focal) are no longer supported.

Use your preferred editor and open (or create) /etc/apt/sources.list.d/cloudstack.list. Add the community provided repository to the file (replace “noble” with “jammy” or “focal” or “bionic” if it is the case):

deb https://download.cloudstack.org/ubuntu noble 4.22

We now have to add the public key to the trusted keys.

wget -O - https://download.cloudstack.org/release.asc |sudo tee /etc/apt/trusted.gpg.d/cloudstack.asc

Now update your local apt cache.

sudo apt update

Your DEB package repository should now be configured and ready for use.

In Debian:

You can also install CloudStack on Debian systems using APT in the same way as on Ubuntu. Replace the Debian release codename (for example, “bookworm” for Debian 12) as appropriate.

Use your preferred editor and open (or create) /etc/apt/sources.list.d/cloudstack.list. Add the community provided repository to the file (replace “bookworm” with the codename of Debian release if it is the case):

deb https://download.cloudstack.org/debian bookworm 4.22

We now have to add the public key to the trusted keys.

wget -O - https://download.cloudstack.org/release.asc |sudo tee /etc/apt/trusted.gpg.d/cloudstack.asc

Now update your local apt cache.

sudo apt update

Your DEB package repository should now be configured and ready for use.

Install on CentOS/RHEL

yum install cloudstack-management

Install on SUSE

zypper install cloudstack-management

Install on Ubuntu/Debian

sudo apt install cloudstack-management