Skip to main content
Organisations in OpenLIT are shared workspaces for teams and environments. An organisation contains projects, and each project contains one or more ClickHouse database configurations. 
Organisation
  Project
    Database configuration
Use organisations for workspace and membership boundaries. Use projects when you need separate database boundaries inside the same organisation, such as production, staging, customer-specific environments, or different teams.

​
What belongs to an organisation

  • Organisation identity, such as the workspace name.
  • Members and pending invitations.
  • Projects owned by the organisation.
  • Billing and licensing state where applicable.
Every organisation has a default project. Existing installations are mapped to a default project so existing database configurations continue to work after upgrading.

​
Common tasks

Manage projects

Create projects, switch project context, and review project-level structure.

Configure databases

Add, select, and update ClickHouse database configurations inside a project.

​
Workspace switching

If you belong to multiple organisations, use the organisation selector in the top navigation to change the active workspace. Project and database configuration selectors update based on the selected organisation.