Helios Documentation

Workspaces & Tenants

Isolate teams, projects, and billing with workspaces.

Setting Up a Workspace

Workspaces are the best way to manage multiple projects or teams under a single organization.

1. Create a Workspace

Navigate to the sidebar and click the "+ New Workspace" button.

2. Name Your Workspace

Give your workspace a descriptive name. See our naming conventions below.

3. Assign Team Members & Roles

Invite members and assign roles to control access.

Use clear and consistent names for your workspaces to keep them organized.

  • By Environment: prod-api, staging-workers, dev-database
  • By Team: data-science-team, frontend-devs, billing-services
  • By Project: project-alpha, project-gamma-inference

Role Permissions

Each role has specific permissions. Use this guide to assign the correct level of access.

RolePermissions
AdminManage billing, manage workspace settings, invite/remove members, delete workspace, all member permissions.
MemberDeploy containers, view logs, manage their own deployments, view workspace settings.
ViewerView deployments and logs. Cannot deploy or change settings.

Multi-tenancy and Isolation

For agencies or resellers, you can create a separate workspace for each client or tenant. This ensures that billing and resources are completely separate, providing a clean and secure multi-tenant environment.

Diagram showing the relationship between workspaces, users, and tenants.