User Avatar

Create Workspace

Workspaces let you group services and clusters by team, environment, or function. This helps manage access and visibility within Komodor.

Prerequisites

  • A Komodor account with admin permissions
  • At least one active cluster connected to Komodor

Step 1: Open the Workspace Settings

  1. Log in to Komodor
  2. In the left sidebar, click Settings
  3. Select Workspaces from the settings menu

Step 2: Create a New Workspace

  1. Click the Create Workspace button
  2. Enter a name and (optional) description
  3. Click Create

You’ll be taken to the workspace configuration page.

Step 3: Assign Services and Clusters

  1. In the workspace view, go to the Clusters & Services tab
  2. Click Assign Clusters and select one or more connected clusters
  3. Click Assign Services to select services by name, label, or namespace

Assignments can be filtered dynamically or set manually.

Step 4: Configure Access Permissions

  1. Go to the Users & Permissions tab
  2. Click Add User or Add Group
  3. Select roles: Viewer, Editor, or Admin

You can manage access using identity provider groups if SSO is enabled.

Step 5: Verify the Workspace

  1. Switch to the new workspace using the workspace dropdown in the top bar
  2. Make sure only the assigned services and clusters are visible
  3. Test access levels by impersonating user roles if needed

Notes

  • Each service or cluster can belong to multiple workspaces
  • Deleting a workspace does not remove clusters or services from Komodor
  • Use labels or naming conventions to automate service assignment