Collaboration on OpenShift

All OpenShift Online plans allow you to manage users that have access to one or more of your OpenShift domains. Premium plans extend this functionality by allowing for additional domains and management of teams.

In This Guide

Managing Domain Membership

All OpenShift Online users have the ability to add collaborators at the domain level. Other OpenShift users can be given access to either View, Edit, or Administer applications associated with a shared domain. The default role for additional members is edit.

Web Console

After logging into the web console, you will see a list of your current domains and applications. Click on the domain you would like to share. You can also select the domain from the Settings tab in the top navigation. In the below example, the domain exampledomainone is selected from the Applications list:

Managing domain membership step 1

Next, you will see the details of the domain you’ve selected. All current OpenShift users that have access to this domain will be listed under the Members section. If there are no members, as in the example below, you can click on Add members…​

Managing domain membership step 2

You can then add new users to the domain, granting either view, edit, or administer access for the user. The user will have access to all applications associated with this domain. Bronze and Silver users will also have the option of adding a team to the domain (see below).

Managing domain membership step 3

Once the new user is added, they will be able to access applications in the shared domain by logging into their own individual OpenShift Online account.

Command Line (rhc)

Add a user to a domain with the following command, specifying the user login and domain name.

The user login must be a registered OpenShift Online user.
$ rhc member add <openshift_username> -n <domain_name>

When a member is added to a domain, they receive the default role of edit. Use the --role option when adding a member to specify a different role:

$ rhc member add <openshift_username> -n <domain_name> --role <member_role>
The three roles available are view, edit, and administer.

Team Management

After logging into the web console, you will see a list of your current domains and applications. Click on the Settings tab in the top navigation:

Team Management Step 1

If you have any existing domains or teams, you will see them listed here. If not, select Create a new team:

Team Management Step 2

Enter the name of the team you would like to create:

A team name must be a unique name between 2 and 250 characters, and cannot be modified once created.
Team Management Step 3

Once the team is created, you can add members to the team:

Team Management Step 4

You can then add or remove existing OpenShift Online users to the new team:

Team Management Step 5

Once the team is created, you can then give the team access to one or more of your existing domains. First from either the Applications list (shown below), or the Settings tab, select the domain you wish to share:

Team Management Step 6

On the domain settings screen, you can choose to add members to the domain. A member can be either an individual user or a team that you’ve created:

Team Management Step 7

Select Add a team…​:

Team Management Step 8

Select a team you’ve created from the dropdown:

Team Management Step 9

Command Line (rhc)

You can create a team with the following command:

$ rhc team create <team_name>
A team name must be a unique name between 2 and 250 characters, and cannot be modified once created.

You can add a member to a team by using the following command:

$ rhc member add <user_name> -t <team_name>

When adding a team to a domain, use the --type option with team specified:

$ rhc member add <team_name> -n <domain_name> --type team  --role <member_role>