Skip to main content
Organisations in OpenLIT let you group team members under a shared workspace. Each organisation contains one or more projects, and each project owns its own ClickHouse database configuration. Resources such as dashboards, prompts, rules, contexts, and secrets are scoped through the selected organisation and project, giving teams isolation without forcing every workspace to become a separate organisation.

​
Key features

  • Workspace isolation: Each organisation maintains its own database configuration and resource space.
  • Project hierarchy: Projects sit inside organisations and group database configurations for different environments, teams, or workloads.
  • Role-based access control: Assign Admin or Member roles to control who can manage settings and invite others.
  • Email invitations: Invite teammates by email. Invitations can be accepted or declined from the notification panel.
  • Multiple organisations: A single user can belong to multiple organisations and switch between them at any time.
  • Member management: Admins can view all members, update roles, and remove users from the organisation.

​
Get started

1

Create an organisation

Set up your first workspace in minutes.
  1. Navigate to Settings → Organisation in OpenLIT.
  2. Click Create Organisation.
  3. Enter a name for your organisation and confirm.
Your new organisation is created and set as the active workspace.
2

Invite team members

Bring your team into the workspace.
  1. Go to Settings → Organisation → Members.
  2. Click Invite Members.
  3. Enter one or more email addresses and select a role (Admin or Member).
  4. Click Send Invites.
Invited users receive an email with a link to accept and join the organisation.
3

Create a project

Add a project when an organisation needs separate database configuration boundaries.
  1. Navigate to Settings → Organisation → Projects.
  2. Enter a project name.
  3. Click Create project.
New projects appear in the project dropdown in the top navigation bar.
4

Switch projects

Projects control which database configuration is active.
  1. Use the project dropdown in the top navigation bar.
  2. Select the project you want to work in.
  3. Open Settings → Organisation to manage the project’s database configuration.
Database configuration lists update to match the selected project.
5

Accept an invitation

When you receive an invitation:
  1. Open the link in the invitation email or log in to OpenLIT.
  2. A notification will show the pending invitation.
  3. Click Accept to join, or Decline to dismiss.
Once accepted, the organisation appears in your workspace switcher.
6

Manage members and roles

Admins have full control over member management.
  1. Navigate to Settings → Organisation → Members.
  2. View all active members and pending invitations.
  3. Change a member’s role between Admin and Member using the role dropdown.
  4. Remove a member by clicking the remove icon next to their name.
  5. Cancel a pending invitation by clicking Cancel next to the invite.
7

Switch organisations

If you belong to multiple organisations:
  1. Click the organisation name in the top navigation bar.
  2. Select the organisation you want to switch to from the dropdown.
All resources update to reflect the selected organisation’s data.

​
Roles and permissions

ActionAdminMember
View dashboards, traces, prompts✅✅
Create / edit resources✅✅
Invite members✅❌
Change member roles✅❌
Remove members✅❌
Delete organisation✅❌
Manage database configuration✅❌
Create and switch projects✅✅

​
Project hierarchy

OpenLIT uses the following hierarchy: 
Organisation
  Project
    Database configuration
Use organisations for account and membership boundaries. Use projects for separate database configuration boundaries inside the same organisation, such as production, staging, customer-specific workspaces, or different teams sharing the same membership model. Every organisation has a default project. Existing organisations are mapped to a default project so database configurations continue to work after upgrading.

Manage LLM secrets

Centrally store LLM API keys that applications can retrieve remotely without restarts

Manage prompts

Version, deploy, and collaborate on prompts with centralized management and tracking

Multiple databases

Connect and switch between multiple ClickHouse database configurations