OpenStack API and CLI (command line interface)

Last changed: 2022-12-02

You will get a password when you do the initial first login (see Logging in). Please make sure you write this down for later use.

If you were an early adopter or forgot your password, you can reset your password by clicking on “Reset API password” on access page.

OpenStack Command Line Interface (CLI)

Installing the CLI tools

Before using the command line tools, they need to be installed. A relatively recent version of the command line tools are available natively on some Linux distributions. There are also versins available for other operating systems like Apple OS X and Microsoft Windows. Please check documentation at OpenStack: OpenStackClient for more information.

Fedora Linux

Installing on Fedora is simple, using the native package manager:

# dnf install python3-openstackclient

In order to use the DNS service you also need the designate client package:

# dnf install python3-designateclient

In order to install the CLI tools on RHEL, you need to enable the proper repository using subscription-manager:

  • For RHEL9:

    # subscription-manager repos --enable=openstack-17-tools-for-rhel-9-x86_64-rpms
  • For RHEL8:

    # subscription-manager repos --enable=openstack-16-tools-for-rhel-8-x86_64-rpms
  • For RHEL7 Workstation:

    # subscription-manager repos --enable=rhel-7-workstation-openstack-14-tools-rpms
  • For RHEL7 Server:

    # subscription-manager repos --enable=rhel-7-server-openstack-14-tools-rpms

Then, install the CLI tools using yum:

  • For RHEL8 and RHEL9:

    # yum install python3-openstackclient
  • For RHEL7:

    # yum install python2-openstackclient

In order to use the DNS service you also need the designate client package:

  • For RHEL8 and RHEL9:

    # yum install python3-designateclient
  • For RHEL7:

    # yum install python2-designateclient

Using the CLI tools

After you receive your password for API access you can use the OpenStack command line interface (OpenStack CLI) to test the access.

Create a file:

export OS_USERNAME=<feide-id>
export OS_PROJECT_NAME=<project>
export OS_PASSWORD=<password>
export OS_AUTH_URL=
export OS_USER_DOMAIN_NAME=dataporten
export OS_PROJECT_DOMAIN_NAME=dataporten
export OS_REGION_NAME=<region>
export OS_INTERFACE=public
export OS_NO_CACHE=1

The above is a template. Replace the following:

  • Replace <feide-id> with your FEIDE identity, e.g. “”
  • Replace <project> with the project name, e.g. “”
  • Replace <password> with the API password that you got when first logging in, or create a new API passord by visiting and clicking on “Reset API password”
  • Replace <region> with either “osl” or “bgo”, whichever you want to use.

This file contains your API password, and should be protected. At a minimum, make sure that you are the only one with read and write access:

$ chmod 0600

When this file has been created, you should be able to source it and run openstack commands:

$ source
$ openstack server list
| ID                                   | Name | Status | Networks             | Image Name |
| 5a102c14-83fd-4788-939e-bb2e635e49de | test | ACTIVE | public= | Fedora 24  |

Read more about the OpenStack CLI at