Manage Projects

Overview

Projects are the fundamental resource namespace in Polystack. Every instance, volume, network, and image belongs to a project. Projects allow you to isolate resources between teams, enforce independent quotas, and apply fine-grained role-based access control. This guide covers creating projects, adding members, assigning roles, and managing project lifecycle.

Prerequisites

An active Polystack account with appropriate permissions
Access to the Polystack Dashboard or CLI configured with credentials
API credentials sourced (source openrc.sh)

Create a Project

Dashboard
CLI

Navigate to Identity

Navigate to Identity > Projects (admin view).

Create a project

Click Create Project and fill in the form:

Field	Description
Name	Unique identifier within the domain
Description	Optional — describes the project’s purpose
Enabled	Toggle on to allow resource creation immediately

Use a consistent naming convention such as team-environment (e.g., backend-prod, frontend-staging) to keep the project list scannable as it grows.

Confirm creation

Click Confirm. The project appears in the list immediately.

The new project is visible in Identity > Projects (admin view) with status Enabled.

Authenticate

Source your credentials file to authenticate with the Polystack platform:

Load credentials

source openrc.sh

Your administrator provides the RC (credentials) file for your project. See CLI Setup for configuration details.

Create the project

Create project

openstack project create \
  --domain Default \
  --description "Backend production environment" \
  backend-prod

List projects

List all projects

openstack project list

Show project details

openstack project show backend-prod

Manage Project Members

Add users to a project and assign the appropriate role to control what each user can do.

Dashboard
CLI

Open project members

Navigate to Identity > Projects (admin view). On the target project row, click the More dropdown and select Manage User.

Add a member

Click Add Member, select a user from the dropdown, and select a role:

Role	What the user can do
`admin`	Full management rights — create, modify, delete all resources and manage users
`member`	Standard access — create and manage resources within the project
`reader`	Read-only — view resources but cannot create or modify anything

Changes take effect on the user’s next token request. Existing tokens retain the old permissions until they expire.

Confirm membership

The user appears in the members list with the assigned role.

Grant a role

Grant role to user in project

openstack role add \
  --project backend-prod \
  --user alice \
  member

No output is returned on success — the absence of an error confirms the assignment.

Verify role assignment

List role assignments for user

openstack role assignment list \
  --user alice \
  --project backend-prod \
  --names

The role assignment appears in the output with the correct project and user names.

Remove a role

Revoke role from user in project

openstack role remove \
  --project backend-prod \
  --user alice \
  member

Update and Disable Projects

Dashboard
CLI

Open the project in Identity > Projects (admin view) and click Edit to modify the name, description, or enabled state. Disabling a project immediately prevents new resource creation but does not delete existing resources.

openstack project set --name new-name backend-prod

openstack project set --disable backend-prod

openstack project set --enable backend-prod

openstack project delete backend-prod

Deleting a project does not automatically delete the resources within it. Clean up instances, volumes, and networks before deleting to avoid orphaned resources that continue consuming quota.

Project Quotas

Quotas cap the total resources a project can consume. Administrators set quotas per project to prevent any single team from exhausting shared infrastructure.

View current project quotas

openstack quota show backend-prod

Check actual usage against quotas

openstack quota show --usage backend-prod

Quota changes are applied by your platform administrator. Contact your admin or refer to the Identity Admin Guide to modify project quotas.

Next Steps

Users

Create user accounts and assign them to projects with appropriate roles.

Application Credentials

Generate non-interactive credentials scoped to project roles for automation pipelines.

Compute User Guide

Launch and manage compute instances within your project.

Identity Admin Guide

Configure domain management, token policies, and authentication backends.

Core Services

Other Services

Overview

Create a Project

Navigate to Identity

Create a project

Confirm creation

Authenticate

Create the project

List projects

Manage Project Members

Open project members

Add a member

Confirm membership

Grant a role

Verify role assignment

Remove a role

Update and Disable Projects

Project Quotas

Next Steps

Users

Application Credentials

Compute User Guide

Identity Admin Guide

​Overview

​Create a Project

Navigate to Identity

Create a project

Confirm creation

Authenticate

Create the project

List projects

​Manage Project Members

Open project members

Add a member

Confirm membership

Grant a role

Verify role assignment

Remove a role

​Update and Disable Projects

​Project Quotas

​Next Steps

Users

Application Credentials

Compute User Guide

Identity Admin Guide

Overview

Create a Project

Manage Project Members

Update and Disable Projects

Project Quotas

Next Steps