Chapter 6. Workspaces


Workspaces can group your systems for easier management, filtering across applications, and user access control. Using workspaces can help enhance your operational efficiency and security.

6.1. Workspace characteristics

Workspaces in Red Hat Lightspeed organize systems based on criteria such as environment, application, or team ownership to streamline workflows and control access.

In Red Hat Lightspeed, workspaces are only for systems. By assigning systems to specific workspaces, you streamline workflows and ensure that users have access only to the systems relevant to their roles. Systems that are not assigned to a specific workspace are automatically grouped within the Ungrouped Hosts workspace.

6.2. Workspace limits and restrictions

Learn about the limits and restrictions that apply to inventory workspaces in your organization.

6.2.1. Organization workspace limit

  • Each organization can create up to 120 workspaces.

    • This limit includes both workspaces with systems and empty workspaces.
    • If you reach this limit, you cannot create additional workspaces until you free up capacity by deleting existing workspaces.
    • The default Ungrouped Hosts workspace does not count toward this limit.

6.2.2. Workspace naming restrictions

  • Names can consist of lowercase letters, numbers, spaces, hyphens (-), and underscores (_).
  • Names must be unique within your organization.

6.2.3. Workspace structure restrictions

  • Workspaces cannot be nested.

6.2.4. System assignment restrictions

  • Each system can belong to only one workspace at a time.
  • Systems that are not assigned to a workspace are automatically grouped in the Ungrouped Hosts workspace.

6.3. Creating a workspace

In the Red Hat Hybrid Cloud Console, you can create a workspace to organize systems by environment, team ownership, application type, or geographical location. This enables you to filter system views across applications, control user access to specific systems, and streamline operational workflows.

Prerequisites

  • You must be an Organization Administrator (member of the Default admin access group) or have one of the following roles:

    • Workspace administrator
    • RHEL administrator
    • RHEL operator
Important

Each organization can create up to 120 workspaces. If you reach this limit, an error occurs, and you must delete existing workspaces before creating new ones. For more information, see Workspace limits and restrictions.

Procedure

  1. On the Hybrid Cloud Console, navigate to System > Inventory.
  2. Click the Inventory drop-down menu and select Workspaces.
  3. Click Create workspace. The Create workspace dialog box is displayed.
  4. Type a name for the workspace in the Workspace name field. Names can consist of lowercase letters, numbers, spaces, hyphens (-), and underscores (_).
  5. Click Create. The new workspace is displayed in the list of workspaces.

6.4. Adding systems to a newly created workspace

In the Red Hat Hybrid Cloud Console, you can add systems to a workspace to organize them by team, environment, or application. This enables you to control user access to those specific systems.

Note

Each system can belong to only one workspace. To move a system to a different workspace, you must first remove it from its current workspace and then assign it to the new workspace.

Prerequisites

  • You must be an Organization Administrator (member of the Default admin access group) or your user account must be a member of a group with at least the following role permissions:

    • Workspace administrator
    • RHEL administrator
    • inventory:groups:write and inventory:groups:read permissions for that particular workspace

Procedure

  1. On the Hybrid Cloud Console, navigate to System > Inventory.
  2. Click the Inventory drop-down menu and select Workspaces.
  3. Click the name of the group to which you want to add systems.
  4. On the Systems tab, click Add systems. The Add systems dialog box displays and shows the systems available for you to view in inventory.
  5. Select the systems you want to add to the workspace.

    Note

    Make sure that all the systems you have selected are ungrouped, or you will not be able to proceed.

  6. When you have finished selecting systems, click Add systems. The Workspaces page displays and includes the systems you added to the workspace.

Prerequisites

  • You must be an Organization Administrator (member of the Default admin access group) or have one of the following roles:

    • Workspace administrator
    • RHEL administrator
    • RHEL operator
    • inventory:groups:write and inventory:groups:read permissions for that particular workspace

Procedure

  1. On the Hybrid Cloud Console, navigate to System > Inventory. The list of systems in your inventory appears.
  2. Locate the system that you want to add.
  3. Click the More options icon (⋮) on the far right side of the system listing.
  4. Select Add to workspace from the pop-up menu. The Add to workspace dialog box displays.
  5. Click Create a new workspace. The Create workspace dialog box displays.
  6. Type a name for the new group in the Name field and click Create.

The Inventory page appears and displays a status (success or failure) message.

6.5. Removing systems from the workspace

In the Red Hat Hybrid Cloud Console, you can remove systems from a workspace when they no longer belong to that group. Removed systems automatically move to a workspace named Ungrouped Hosts.

Prerequisites

  • You must be an Organization Administrator (member of the Default admin access group) or have one of the following roles:

    • Workspace administrator
    • RHEL administrator
    • RHEL operator
    • inventory:groups:write permissions for that particular workspace

Procedure

  1. On the Hybrid Cloud Console, navigate to System > Inventory.
  2. Click the Inventory drop-down menu and select Workspaces. The Workspaces page displays.
  3. Select the workspace that contains the systems that you want to remove.
  4. Locate the system that you want to remove from the workspace.
  5. Click the More options icon (⋮) on the far right side of the system listing.
  6. Select Remove from workspace from the pop-up menu. The Remove from workspace? dialog box displays.
  7. Optional: To remove multiple systems from the workspace at once, select each system you want to remove, and then select Remove from workspace from the More options menu (the options icon (⋮)) in the toolbar.
  8. Click Remove.

The Workspaces page displays and shows the updated workspace with a status (success or failure) message.

6.6. Renaming the workspace

In the Red Hat Hybrid Cloud Console, you can rename a workspace to better reflect its purpose, such as when team ownership changes or system groupings are reorganized.

Prerequisites

  • You must be an Organization Administrator (member of the Default admin access group) or have one of the following roles:

    • Workspace administrator
    • RHEL administrator
    • RHEL operator
    • inventory:groups:write permissions for that particular workspace

Procedure

  1. On the Hybrid Cloud Console, navigate to System > Inventory.
  2. Click the Inventory drop-down menu and select Workspaces. The Workspaces page displays.
  3. Click the Workspace actions drop-down menu in the upper right corner of the Workspaces page.
  4. Select Rename from the drop-down menu. The Rename workspace dialog box displays.
  5. Type the new name into the Name field, and click Save.
  6. The Workspaces page shows the renamed workspace in the list of workspaces.

6.7. Deleting the workspace

In the Red Hat Hybrid Cloud Console, you can delete a workspace when you no longer need it to organize systems. This helps you manage workspace capacity and stay within the organization limit.

Note

Before you delete a workspace, make sure that the workspace does not contain any systems. You can only delete empty workspaces. If you attempt to delete a workspace that still contains systems, Red Hat Lightspeed returns a warning message.

Prerequisites

  • You must be an Organization Administrator (member of the Default admin access group) or have one of the following roles:

    • Workspace administrator
    • RHEL administrator
    • RHEL operator
    • inventory:groups:write permissions for that particular workspace

Procedure

  1. On the Hybrid Cloud Console, navigate to System > Inventory.
  2. Click the Inventory drop-down menu and select Workspaces. The Workspaces page displays.
  3. Click the options icon (⋮) on the far right side of the listing for the group you want to delete.
  4. Select Delete from the menu. The Delete workspace dialog box displays.
  5. Select the checkbox to acknowledge that the delete operation cannot be undone. Click Delete.

The Workspaces page shows an updated list of workspaces and a status (success or failure) message.

Note

You can also delete the workspace from within the page for the workspace itself. Navigate to the workspace and click the Actions drop-down menu and then select Delete.

6.8. Troubleshooting workspace creation errors

In the Red Hat Hybrid Cloud Console, you may encounter errors when creating workspaces, such as workspace limit errors, permission issues, or duplicate name conflicts. Use this procedure to diagnose and resolve these errors.

Procedure

  1. If you see "Failed to create workspace" or "Workspace limit reached (120/120)":

    Your organization has reached the maximum limit of 120 workspaces. To resolve this issue, free up workspace capacity by using one of the following methods:

    • Delete empty workspaces: On the Hybrid Cloud Console, navigate to System > Inventory, click the Inventory drop-down menu and select Workspaces, identify workspaces that contain no systems, and delete the ones you no longer need. For details, see Deleting workspaces.
    • Merge workspaces: Review your existing workspaces to identify those with similar user groups and role bindings. Move systems from many workspaces into a single workspace and delete the now-empty workspaces.
    • Remove systems before deleting: Before deleting a workspace that has systems, remove the systems from the workspace or move them to another workspace. Systems removed from a workspace automatically move to the Ungrouped Hosts workspace.

      After you delete one or more workspaces, you can create new workspaces.

  2. If you see "Workspace access permissions needed":

    You do not have the required permissions to view or create workspaces. Contact your organization administrator to request the Workspace administrator role. For details about workspace permissions, see User access to workspaces.

  3. If you see an error that a workspace name already exists:

    Workspace names must be unique within your organization. Another workspace is already using the name you entered. Choose a different name for your workspace. Workspace names can consist of lowercase letters, numbers, spaces, hyphens (-), and underscores (_).

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

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

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.

Theme

© 2026 Red Hat
Back to top