OpenStack packages for RHEL and CentOS

Distributions release OpenStack packages as part of the distribution or using other methods because of differing release schedules. Perform these procedures on all nodes.


Starting with the Ussuri release, you will need to use either CentOS8 or RHEL 8. Previous OpenStack releases will need to use either CentOS7 or RHEL 7. Instructions are included for both distributions and versions where different.


The set up of OpenStack packages described here needs to be done on all nodes: controller, compute, and Block Storage nodes.


Your hosts must contain the latest versions of base installation packages available for your distribution before proceeding further.


Disable or remove any automatic update services because they can impact your OpenStack environment.



We recommend disabling EPEL when using RDO packages due to updates in EPEL breaking backwards compatibility. Or, preferably pin package versions using the yum-versionlock plugin.


The following steps apply to RHEL only. CentOS does not require these steps.

  1. When using RHEL, it is assumed that you have registered your system using Red Hat Subscription Management and that you have the rhel-7-server-rpms or rhel-8-for-x86_64-baseos-rpms repository enabled by default depending on your version.

    For more information on registering a RHEL 7 system, see the Red Hat Enterprise Linux 7 System Administrator’s Guide.

  2. In addition to rhel-7-server-rpms on a RHEL 7 system, you also need to have the rhel-7-server-optional-rpms, rhel-7-server-extras-rpms, and rhel-7-server-rh-common-rpms repositories enabled:

    # subscription-manager repos --enable=rhel-7-server-optional-rpms \
      --enable=rhel-7-server-extras-rpms --enable=rhel-7-server-rh-common-rpms

    For more information on registering a RHEL 8 system, see the Red Hat Enterprise Linux 8 Installation Guide.

    In addition to rhel-8-for-x86_64-baseos-rpms on a RHEL 8 system, you also need to have the rhel-8-for-x86_64-appstream-rpms, rhel-8-for-x86_64-supplementary-rpms, and codeready-builder-for-rhel-8-x86_64-rpms repositories enabled:

    # subscription-manager repos --enable=rhel-8-for-x86_64-appstream-rpms \
      --enable=rhel-8-for-x86_64-supplementary-rpms --enable=codeready-builder-for-rhel-8-x86_64-rpms

Enable the OpenStack repository

  • On CentOS, the extras repository provides the RPM that enables the OpenStack repository. CentOS includes the extras repository by default, so you can simply install the package to enable the OpenStack repository. For CentOS8, you will also need to enable the PowerTools repository.

    When installing the Victoria release, run:

    # yum install centos-release-openstack-victoria
    # yum config-manager --set-enabled powertools

    When installing the Ussuri release, run:

    # yum install centos-release-openstack-ussuri
    # yum config-manager --set-enabled powertools

    When installing the Train release, run:

    # yum install centos-release-openstack-train

    When installing the Stein release, run:

    # yum install centos-release-openstack-stein

    When installing the Rocky release, run:

    # yum install centos-release-openstack-rocky

    When installing the Queens release, run:

    # yum install centos-release-openstack-queens

    When installing the Pike release, run:

    # yum install centos-release-openstack-pike
  • On RHEL, download and install the RDO repository RPM to enable the OpenStack repository.

    On RHEL 7:

    # yum install

    On RHEL 8:

    # dnf install

    The RDO repository RPM installs the latest available OpenStack release.

Finalize the installation

  1. Upgrade the packages on all nodes:

    # yum upgrade


    If the upgrade process includes a new kernel, reboot your host to activate it.

  2. Install the appropriate OpenStack client for your version.

    For CentOS 7 and RHEL 7

    # yum install python-openstackclient

    For CentOS 8 and RHEL 8

    # yum install python3-openstackclient
  3. RHEL and CentOS enable SELinux by default. Install the openstack-selinux package to automatically manage security policies for OpenStack services:

    # yum install openstack-selinux