Skip to content

Managing Projects and Organizations

Beginner 10 minutes

Overview

Organizations and projects help structure users and resources in RosettaHub. In this tutorial you will list organizations and projects, create a new project, manage users, and use masquerade to act on behalf of managed users.

Prerequisites

Steps

Step 1: List Your Organizations

rh org ls

This shows all organizations you belong to, with their UIDs, labels, and structure.

View the organization tree:

rh org tree

Step 2: List Projects

List all projects you have access to:

rh project ls

Step 3: Create a New Project

rh project create --label "ML Experiments" --description "Machine learning workloads"

Preview without creating:

rh project create --label "ML Experiments" --dry-run

Step 4: Connect to a Project

Connect to an existing project to manage its resources:

rh project connect <projectUid>

Open a project in the browser:

rh project browse <projectUid>

Step 5: List and Manage Users

See users you manage:

rh user ls

Masquerade as a managed user (requires Superuser rights on that user):

rh user masquerade <username>

Tip

Masquerading lets you perform actions on behalf of another user you manage. This is useful for administrators setting up resources for their team.

Step 6: Use Different Output Formats

Export listings for reporting or scripting:

rh user ls -O json     # JSON output
rh project ls -O csv   # CSV for spreadsheets
rh org ls -O yaml      # YAML format

Or set the default format globally:

rh set-output json

Next Steps

Troubleshooting

Cannot create a project

Project creation requires manager or admin privileges in your organization.

Cannot masquerade as a user

Masquerading requires Superuser rights on the target user. Contact your organization admin.

Project list is empty

Ensure you are connected with the right user. Check with rh whoami and rh get-default.