Chapter 7. Organizations

download PDF

An organization is a logical collection of users, teams, projects, and inventories. It is the highest level object in the controller object hierarchy.


From the navigation menu, select Organizations to display the existing organizations for your installation.


Organizations can be searched by Name or Description.

Modify organizations using the Edit icon. Click Delete to remove a selected organization.

7.1. Creating an organization


Automation controller automatically creates a default organization. If you have a Self-support level license, you have only the default organization available and must not delete it.

You can use the default organization as it is initially set up and edit it later.

  1. Click Add to create a new organization.

    Organizations- new organization form

  2. You can configure several attributes of an organization:

    • Enter the Name for your organization (required).
    • Enter a Description for the organization.
    • Max Hosts is only editable by a superuser to set an upper limit on the number of license hosts that an organization can have. Setting this value to 0 signifies no limit. If you try to add a host to an organization that has reached or exceeded its cap on hosts, an error message displays:

      The inventory sync output view also shows the host limit error.


      Click Details for additional information about the error.

    • Enter the name of the Instance Groups on which to run this organization.
    • Enter the name of the execution environment or search for one that exists on which to run this organization. For more information, see Upgrading to Execution Environments.
    • Optional: Enter the Galaxy Credentials or search from a list of existing ones.
  3. Click Save to finish creating the organization.

When the organization is created, automation controller displays the Organization details, and enables you to manage access and execution environments for the organization.

Organization details

From the Details tab, you can edit or delete the organization.


If you attempt to delete items that are used by other work items, a message lists the items that are affected by the deletion and prompts you to confirm the deletion. Some screens contain items that are invalid or have been deleted previously, and will fail to run.

The following is an example of such a message:


7.2. Access to organizations

  • Select Access when viewing your organization to display the users associated with this organization, and their roles.

Organization access

Use this page to complete the following tasks:

  • Manage the user membership for this organization. Click Users on the navigation panel to manage user membership on a per-user basis from the Users page.
  • Assign specific users certain levels of permissions within your organization.
  • Enable them to act as an administrator for a particular resource. For more information, see Role-Based Access Controls.

Click a user to display that user’s details. You can review, grant, edit, and remove associated permissions for that user. For more information, see Users.

7.2.1. Add a User or Team

To add a user or team to an organization, the user or team must already exist.

For more information, see Creating a User and Creating a Team.

To add existing users or team to the Organization:


  1. In the Access tab of the Organization page, click Add.
  2. Select a user or team to add.
  3. Click Next.
  4. Select one or more users or teams from the list by clicking the checkbox next to the name to add them as members.
  5. Click Next.

    Add roles

    In this example, two users have been selected.

  6. Select the role you want the selected user or team to have. Scroll down for a complete list of roles. Different resources have different options available.

    Add user roles

  7. Click Save to apply the roles to the selected user or team, and to add them as members. The Add Users or Add Teams window displays the updated roles assigned for each user and team.


    A user or team with associated roles retains them if they are reassigned to another organization.

  8. To remove roles for a particular user, click the disassociate Disassociate icon next to its resource. This launches a confirmation dialog, asking you to confirm the disassociation.

7.2.2. Work with Notifications

Selecting the Notifications tab on the Organization details page enables you to review any notification integrations you have set up.


Use the toggles to enable or disable the notifications to use with your particular organization. For more information, see Enable and Disable Notifications.

If no notifications have been set up, select Administration Notifications from the navigation panel.

For information on configuring notification types, see Notification Types.

Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.