Managing cloud resources with the OpenStack Dashboard

download PDF
Red Hat OpenStack Platform 17.1

Viewing and configuring the OpenStack Dashboard GUI

OpenStack Documentation Team


This guide provides an outline of the options available in the Red Hat OpenStack Platform Dashboard user interface.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.

Providing feedback on Red Hat documentation

We appreciate your input on our documentation. Tell us how we can make it better.

Providing documentation feedback in Jira

Use the Create Issue form to provide feedback on the documentation. The Jira issue will be created in the Red Hat OpenStack Platform Jira project, where you can track the progress of your feedback.

  1. Ensure that you are logged in to Jira. If you do not have a Jira account, create an account to submit feedback.
  2. Click the following link to open a the Create Issue page: Create Issue
  3. Complete the Summary and Description fields. In the Description field, include the documentation URL, chapter or section number, and a detailed description of the issue. Do not modify any other fields in the form.
  4. Click Create.

Chapter 1. The Red Hat OpenStack Platform Dashboard service (horizon)

The Red Hat OpenStack Platform (RHOSP) Dashboard (horizon) is a web-based graphical user interface that you can use to manage RHOSP services.

To access the browser dashboard, you must install the Dashboard service, and you must know the dashboard host name, or IP, and login password. The dashboard URL is:


1.1. The Admin tab

In the Admin tab you can view usage and manage instances, volumes, flavors, images, projects, users, services, and quotas.


The Admin tab displays in the main window when you log in as an admin user.

The following options are available in the Admin tab:

Table 1.1. System Panel
Parameter nameDescription


View basic reports.

Resource Usage

Use the following tabs to view the following usages:

  • Usage Report - View the usage report.
  • Stats - View the statistics of all resources.


View the hypervisor summary.

Host Aggregates

View, create, and edit host aggregates. View the list of availability zones.


View, pause, resume, suspend, migrate, soft or hard reboot, and delete running instances that belong to users of some, but not all, projects. Also, view the log for an instance or access an instance with the console.


View, create, edit, and delete volumes, and volume types.


View, create, edit, view extra specifications for, and delete flavors. Flavors are the virtual hardware templates in Red Hat OpenStack Platform (RHOSP).


View, create, edit properties for, and delete custom images.


View, create, edit properties for, and delete networks.


View, create, edit properties for, and delete routers.

Floating IPs

View allocated floating IP addresses for all projects.


View and edit the default quotas (maximum limits) for resources in the environment.

Metadata Definitions

Import, view, and edit metadata definition namespaces, and associate the metadata definitions with specific resource types.

System Information

Contains the following tabs:

  • Services - View a list of the services.
  • Compute Services - View a list of all Compute services.
  • Network Agents - View the network agents.
  • Block Storage Services - View a list of all Block Storage services.
  • Orchestration Services - View a list of all Orchestration services.

1.1.1. Viewing allocated floating IP addresses

You can use the Floating IPs panel to view a list of allocated floating IP addresses. You can access the same information from the command line with the nova list --all-projects command.

1.2. The Project tab

In the Project tab you can view and manage project resources. Set a project as active in Identity > Projects to view and manage resources in that project.

The following options are available in the Project tab:

Table 1.2. The Compute tab
Parameter nameDescription


View reports for the project.


View, launch, create a snapshot from, stop, pause, or reboot instances, or connect to them through the console.


Use the following tabs to complete these tasks:

  • Volumes - View, create, edit, and delete volumes.
  • Volume Snapshots - View, create, edit, and delete volume snapshots.


View images, instance snapshots, and volume snapshots that project users create, and any images that are publicly available. Create, edit, and delete images, and launch instances from images and snapshots.

Access & Security

Use the following tabs to complete these tasks:

  • Security Groups - View, create, edit, and delete security groups and security group rules.
  • Key Pairs - View, create, edit, import, and delete key pairs.
  • Floating IPs - Allocate an IP address to or release it from a project.
  • API Access - View API endpoints, download the OpenStack RC file, download EC2 credentials, and view credentials for the current project user.
Table 1.3. The Network tab
Parameter nameDescription

Network Topology

View the interactive topology of the network.


Create and manage public and private networks and subnets.


Create and manage routers.


Create and manage trunks. Requires the trunk extension enabled in OpenStack Networking (neutron).

Table 1.4. The Object Store tab
Parameter nameDescription


Create and manage storage containers. A container is a storage compartment for data, and provides a way for you to organize your data. It is similar to the concept of a Linux file directory, but it cannot be nested.

Table 1.5. The Orchestration tab
Parameter nameDescription


Orchestrate multiple composite cloud applications with templates, through both an OpenStack-native REST API and a CloudFormation-compatible Query API.

1.3. The Identity tab

In the Identity tab you can view and manage projects and users.

The following options are available in the Identity tab:

  • Projects - View, create, edit, and delete projects, view project usage, add or remove users as project members, modify quotas, and set an active project.
  • Users - View, create, edit, disable, and delete users, and change user passwords. The Users tab is available when you log in as an admin user.

For more information about managing your cloud with the Red Hat OpenStack Platform dashboard, see the following guides:

Chapter 2. Customizing the dashboard

The Red Hat OpenStack Platform (RHOSP) dashboard (horizon) uses a default theme (RCUE), which is stored inside the horizon container. You can add your own theme to the container image and customize certain parameters to change the look and feel of the following dashboard elements:

  • Logo
  • Site colors
  • Stylesheets
  • HTML title
  • Site branding link
  • Help URL

To ensure continued support for modified RHOSP container images, the resulting images must comply with the Red Hat Container Support Policy.

2.1. Obtaining the horizon container image

To obtain a copy of the horizon container image, pull the image either into the undercloud or a separate client system that is running podman.


  • Pull the horizon container image:

    $ sudo podman pull

    You can use this image as a basis for a modified image.

2.2. Obtaining the RCUE theme

The horizon container image uses the Red Hat branded RCUE theme by default. You can use this theme as a basis for your own theme and extract a copy from the container image.


  1. Create a directory for your theme:

    $ mkdir ~/horizon-themes
    $ cd ~/horizon-themes
  2. Start a container that executes a null loop. For example, run the following command:

    $ sudo podman run --rm -d --name horizon-temp /usr/bin/sleep infinity
  3. Copy the RCUE theme from the container to your local directory:

    $ sudo podman cp horizon-temp:/usr/share/openstack-dashboard/openstack_dashboard/themes/rcue .
  4. Terminate the container:

    $ sudo podman kill horizon-temp

    Result: You now have a local copy of the RCUE theme.

2.3. Creating your own theme based on RCUE

To use RCUE as a basis, copy the entire RCUE theme directory rcue to a new location. This procedure uses mytheme as an example name.


  • Copy the theme:

    $ cp -r rcue mytheme

To change the colors, graphics, fonts, and other elements of a theme, edit the files in mytheme. When you edit this theme, check for all instances of rcue including paths, files, and directories to ensure that you change them to the new mytheme name.

2.4. Creating a file to enable your theme and customize the dashboard

To enable your theme in the dashboard container, you must create a file to override the AVAILABLE_THEMES parameter.


  1. Create a new file called in the horizon-themes directory and add the following content:

    AVAILABLE_THEMES = [('mytheme', 'My Custom Theme', 'themes/mytheme')]

    The 12 in the file name ensures this file is loaded after the RCUE file, which uses 11, and overrides the AVAILABLE_THEMES parameter.

  2. Optional: You can also set custom parameters in the file. Use the following examples as a guide:


    Set the HTML title that appears at the top of the browser window.

    SITE_BRANDING = "Example, Inc. Cloud"

    Changes the hyperlink of the theme logo, which normally redirects to horizon:user_home by default.


2.5. Generating a modified horizon image

When your custom theme is ready, you can create a new container image that uses your theme.


  1. Use a Dockerfile to generate a new container image using the original horizon image as a basis, as shown in the following example:

    LABEL name="rhosp-rhel8/openstack-horizon-mytheme" vendor="Acme" version="0" release="1"
    COPY mytheme /usr/share/openstack-dashboard/openstack_dashboard/themes/mytheme
    COPY /etc/openstack-dashboard/local_settings.d/
    RUN sudo chown apache:apache /etc/openstack-dashboard/local_settings.d/
  2. Save this file in your horizon-themes directory as Dockerfile.
  3. Use the Dockerfile to generate the new image:

    $ sudo podman build . -t "" --log-level debug

    The -t option names and tags the resulting image. It uses the following syntax:

    This is usually the location of the container registry that the overcloud eventually uses to pull images. In this instance, you push this image to the container registry of the undercloud, so set this to the undercloud IP and port.
    For consistency, this is usually the same name as the original container image followed by the name of your theme. In this instance, it is rhosp-rhel8/openstack-horizon-mytheme.
    The tag for the image. Red Hat uses the version and release labels as a basis for this tag. If you generate a new version of this image, increment the release, for example,0-2.
  4. Push the image to the container registry of the undercloud:

    $ sudo openstack tripleo container image push --local
  5. Verify that the image has uploaded to the local registry:

      [stack@director horizon-themes]$ curl | jq .repositories[] | grep -i hori
      [stack@director horizon-themes]$
      [stack@director ~]$ sudo openstack tripleo container image list | grep hor
      | docker://director.ctlplane.localdomain:8787/rhosp-rhel8/openstack-horizon:16.0-84
      | docker://director.ctlplane.localdomain:8787/rhosp-rhel8/openstack-horizon:0-5  <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<,Uploaded
      [stack@director ~]$

If you update or upgrade Red Hat OpenStack Platform, you must reapply the theme to the new horizon image and push a new version of the modified image to the undercloud.

2.6. Using the modified container image in the overcloud

To use the container image that you modified with your overcloud deployment, edit the environment file that contains the list of container image locations. This environment file is usually named overcloud-images.yaml.


  1. Edit the DockerHorizonConfigImage and DockerHorizonImage parameters to point to your modified container image:

  2. Save this new version of the overcloud-images.yaml file.

2.7. Editing puppet parameters

Director provides a set of dashboard parameters that you can modify with environment files.


Additional resources

2.8. Customizing the share protocols of the Shared File Systems service

You can customize the list of available share protocols in the Manila UI plugin for OpenStack Dashboard (horizon) by using the ExtraConfig parameter in a custom environment file. Modify the ExtraConfig parameter to integrate the puppet parameter that you can use to customize the dashboard options for the Shared File Systems service (manila).


  1. Log in to the undercloud host as the stack user.
  2. Source the stackrc undercloud credentials file:

    $ source ~/stackrc
  3. Create or open a YAML environment file to configure the share protocols that you want to be available to cloud users in the dashboard :


    $ vi /home/stack/templates/<share_protocols>.yaml

    • Replace <share_protocols> with the name of your file.
  4. Configure the puppet parameter that you can use to customize the options for the Shared File Systems service:


    If you use a custom role, use the [role_name]ExtraConfig parameter instead of the ControllerExtraConfig parameter. Replace [role_name] with the name of your custom role.

  5. Configure the list of enabled_share_protocols with the protocols you want to use, for example, the CephFS protocol:

          enabled_share_protocols: ['CEPHFS']
  6. Add your <share_protocols>.yaml file to the stack with your other environment files, and then deploy the overcloud:

    (undercloud)$ openstack overcloud deploy --templates \
    -e [your environment files] \
    -e /home/stack/templates/<share_protocols>.yaml

2.9. Deploying an overcloud with a customized dashboard


  • To deploy the overcloud with your dashboard customizations, include the following environment files in the openstack overcloud deploy command:

    • The environment file with your modified container image locations.
    • The environment file with additional dashboard modifications.
    • Any other environment files that are relevant to your overcloud configuration.

      $ openstack overcloud deploy --templates \
          -e /home/stack/templates/overcloud-images.yaml \
          -e /home/stack/templates/help_url.yaml \
          [OTHER OPTIONS]

Legal Notice

Copyright © 2024 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.