Everything you do and host on the Catalyst Cloud is in a project.

The Catalyst Cloud provides an isolated and multi-tenanted approach to creating workspaces. These workspaces are typically referred to as a project but for historical reasons you may also see them referred to as a tenant or a tenancy.

Finding my project ID

Every project on the Catalyst Cloud has a project name (a user friendly name) and a project id (an auto-generated UUID). There are a number of ways to find your project ID and name.

Via the Dashboard

The project ID and name can be found on the API Access panel by clicking on the View Credentials button.

Via the CLI

If you are using the OpenStack command line interface you have most likely sourced an openrc file, as explained in Command line interface (CLI). If this is the case, you can find your project ID by issuing the following command:


$ echo $OS_Project_NAME

Alternatively, you can use the openstack configuration show command:

$ openstack configuration show -c auth.project_id -f value

$ openstack configuration show -c auth.project_name -f value

Creating new projects

You can request the creation of more projects via the Support Requests panel.

Changing project

Via the dashboard

On the dashboard, you can change which project you are working on using the dropdown on the top left corner.


Via the CLI

The command line interface picks up the project configuration from the $OS_PROJECT_NAME and $OS_PROJECT_ID environment variables.

To define these variable:

export OS_PROJECT_NAME="project-name"

If a project ID is specified, the project name is not used. If only the project name is specified, the CLI will perform a lookup for the name to find the ID.

Alternatively you can use the --os-project-name and --os-project-id options to specify the project on each call.

Project access

The person who signed up to the Catalyst Cloud gets by default the Project Administrator role.

As a project administrator or moderator, you can invite and remove people from your projects using the Project Users Panel.

Project quotas

Each project comes with an initial quota that sets a limit on the amount of cloud resources that you can initially consume. This can be expanded if you need more resources.

Please refer to the quota section of the documentation for more information on quotas.

Project isolation

While projects are inherently secure, it is considered better to use multiple projects where it’s feasible to do so. For example, it is sensible and useful to separate production workloads from development and testing environments, if only to help mitigate the possibility of human error impacting your business.