---
title: "Preparing an environment for using the OpenStack API"
description: "You can manage Public Cloud services using commands sent from the system console, once you have downloaded and installed OpenStack tools."
url: https://docs.us.ovhcloud.com/en/public-cloud/cross-functional/compute-prepare-openstack-api-environment
lang: en
---
> For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt.

# Preparing an environment for using the OpenStack API

You can manage Public Cloud services using commands sent from the system console, once you have downloaded and installed OpenStack tools.

With the OpenStack API, you can automate your management by generating scripts.

**Note:**

OpenStack requires Python >=3.8. This guide describes the installation of the package `python-openstackclient`, which bundles the command line for the majority of OpenStack projects. The Octavia project (which powers the `Public Cloud Load Balancer`) is not included. Hence, you have to run `pip3 install python-octaviaclient` on top of the installation instructions found below. If you need to manage secrets with Barbican, you will need to install an additional package with `pip3 install python-barbicanclient`.

 

## Requirements

- **Root** access to the environment you want to configure

 

## Instructions

### On Debian

Open the terminal, and connect to the environment you want to prepare via SSH.

Update the packet cache using the `apt update` command:

```
apt update
```

Use the command below to install the OpenStack client:

```
$ apt install python3-pip python3-venv -y
$ python3 -m venv env
$ source env/bin/activate
(env)$ pip3 install --upgrade pip
(env)$ pip3 install python-openstackclient
```

After you have completed this step, we recommend creating a special user without root access.

To access the help tools, run the following command:

```
openstack --help
```

**Note:**

The documentation for the OpenStack API is available [here](https://docs.openstack.org/python-openstackclient/latest/).

 

### On CentOS

Open the terminal and connect to the environment you want to prepare via SSH.

Update the packet cache using the following command:

```
yum update -y
```

Use the command below to install the OpenStack client:

```
yum install python3-pip -y
$ python3 -m venv env
$ source env/bin/activate
(env)$ pip3 install --upgrade pip
(env)$ pip3 install python-openstackclient
```

After you have completed this step, we recommend creating a special user without root access.

To access the help tools, run the following command:

```
openstack --help
```

The documentation for the OpenStack API is available [here](https://docs.openstack.org/python-openstackclient/latest/).

 

### On Windows

Download and install Python version 2.7.14. You can choose to add the Python programming language automatically to Path by ticking this option during installation configuration:

You can also install it yourself. To do this, follow the actions described below.

 

#### Step 1: Edit the system’s environment variables.

Search for the system’s environment variable settings, and select `Edit the system environment variables`.

 

#### Step 2: Edit the system settings.

Go to the `Advanced` tab, and click `Environment Variables` to edit the settings.

 

#### Step 3: Configure the environment variables.

In the ‘System variables’ section, select ‘New’, attribute the name “PYTHON\_HOME”, and add the access path to Python. By default, it will be: ‘C:\Python27’.

 

#### Step 4: Add the path for the variables.

Once you have added Python, edit the ‘Path’ field in the system variables, and add the following to the end of the path:

`...;%PYTHON_HOME%\;%PYTHON_HOME%\Script`

 

#### Step 5: Restart Windows.

The changes you have made will become effective after the system has been rebooted.

 

#### Step 6: Install the OpenStack client.

As an administrator, open the program in the command line (CMD), and install the OpenStack client using the following command:

```
pip install python-openstackclient
```

If the operation is completed properly, you will see a summary:

You can check the installation version in the CMD (command line) window that has just opened, by entering ‘python-V’ from any system location.

 

### On MacOS

You can use [HomeBrew](https://brew.sh/), a package manager for MacOS.

Open the terminal and execute the following command:

```
brew install openstackclient
```

To access the help tools, run the following command:

```
openstack --help
```

 

## Go further

Browse all the [Public Cloud - General information guides](https://docs.us.ovhcloud.com/en/public-cloud/cross-functional/landing-page-cross-functional.md).

Browse the rest of the [OVHcloud US documentation](https://docs.us.ovhcloud.com/en/index.md) for guides on our other products and services.

Learn more about [Public Cloud](https://us.ovhcloud.com/public-cloud/) on the OVHcloud US website.