OpenStackClient (aka OSC) is a command-line client for OpenStack that brings the command set for Compute, Identity, Image, Object Store and Block Storage APIs together in a single shell with a uniform command structure. 1


Possibly release names (e.g. pike) are already obsolete. Then just use the current release.

An overview of OpenStack releases can be found at


We provide Ubuntu based Docker Images with the OpenStack client.

  • Use of the integrated shell

    $ docker run -it osism/openstackclient:rocky -v $(pwd):/configuration --os-cloud sample
    (openstack) token issue
  • Direct call of commands

    $ docker run -it osism/openstackclient:rocky -v $(pwd):/configuration --os-cloud sample token issue


  1. Add latest Ubuntu Cloud Archive (UCA) repository: sudo add-apt-repository cloud-archive:pike (add-apt-repository is part of the package software-properties-common)

  2. Install python-openstackclient: sudo apt-get install python-openstackclient


The package python-openstackclient does not install all OpenStack Python client libraries as dependencies. Install these manually if plugins are missing/not usable in python-openstackclient, e.g.```sudo apt-get install python-heatclient`` to be able to use the Heat plugin.


  1. Create and activate a virtual environment: virtualenv -p python3 .venv && source .venv/bin/activate (virtualenv is part of the package virtualenv)

  2. Install the latest released version of python-openstackclient: pip install python-openstackclient


The installed dependencies require the installation of additional development packages, such as pyhton-dev on Ubuntu.


An installation of the master branch is also possible: pip install git+