Chapter 5. Organizations overview
Organizations in Quay group users, repositories, and teams under a shared namespace for centralized access control. Administrators can assign roles and permissions to teams and users within an organization.
Other useful information about organizations includes the following:
- You cannot have an organization embedded within another organization. To subdivide an organization, you use teams.
Organizations cannot contain users directly. You must first add a team, and then add one or more users to each team.
NoteIndividual users can be added to specific repositories inside of an organization. Consequently, those users are not members of any team on the Repository Settings page. The Collaborators View on the Teams and Memberships page shows users who have direct access to specific repositories within the organization without needing to be part of that organization specifically.
- Teams can be set up in organizations as just members who use the repositories and associated images, or as administrators with special privileges for managing the Organization.
Users can create their own organization to share repositories of container images. This can be done through the Quay.io UI.
5.1. Creating an organization by using the UI Copy linkLink copied to clipboard!
To create an organization in Quay, you can use the UI. You set an organization name and then manage repositories and teams under that namespace.
In context of organizations, the contact email is used for the following purposes:
- Quota warnings notifications
- Quota errors notifications
- Organization account recovery
- Billing notifications
Use the following procedure to create a new organization by using the UI.
Procedure
- Log in to your Red Hat Quay registry.
- Click Organization in the navigation pane.
- Click Create Organization.
-
Enter an Organization Name, for example,
testorg. Optional: Enter an Email for the organization. If not specified, notifications default to the organization owners.
NoteMultiple organizations can share the same organization email address, such as a team distribution list. By default, the address cannot match a user account email unless
FEATURE_ORG_SHARED_EMAILis enabled.Click Create.
Now, your example organization should populate under the Organizations page.
5.2. Organization settings Copy linkLink copied to clipboard!
To manage organization settings in Quay, you can use the v2 UI. You can update organization details and related configuration options.
With Quay, some basic organization settings can be adjusted by using the UI. This includes adjusting general settings, such as the e-mail address associated with the organization, and time machine settings, which allows administrators to adjust when a tag is garbage collected after it is permanently deleted.
Use the following procedure to alter your organization settings by using the v2 UI.
Procedure
- On the v2 UI, click Organizations.
-
Click the name of the organization that you will create the robot account for, for example,
test-org. - Click the Settings tab.
Optional. Enter or update the organization Email for the organization in the Email field. This email receives automated system alerts including quota warnings, security notifications, and build failures.
NoteMultiple organizations can share the same organization email address. By default, the address cannot match a user account email unless
FEATURE_ORG_SHARED_EMAILis enabled.Optional. Set the allotted time for the Time Machine feature to one of the following:
- A few seconds
- A day
- 7 days
- 14 days
- A month
- Click Save.