Skip to main content

Tenant setup

The first day after your tenant is provisioned.

What you'll learn​

  • The setup checklist
  • Configuring SSO
  • Configuring billing
  • Creating your initial workspaces

Setup checklist​

  1. Verify your primary domain — adds a TXT record to prove ownership
  2. Configure SSO — connect your IdP (Okta, Google Workspace, Azure AD, OneLogin)
  3. Set up billing — payment method, billing email, tax ID
  4. Create initial workspaces — typically one per team
  5. Invite admins — promote 1-3 trusted people to tenant admin
  6. Define RBAC roles — start with the defaults, add your own roles later
  7. Configure security policies — MFA enforcement, session timeout, password rules
  8. Enable audit log retention — choose retention period

Verify your primary domain​

Tenant Settings → Domain → enter your domain (e.g., acme.com) → copy the TXT record → add it to your DNS → click Verify.

Domain verification gates SSO setup and enables auto-provisioning by email domain.

Configure SSO​

→ Detailed guide depends on IdP. Find provider-specific instructions under Tenant Settings → SSO.

Quick summary:

  • SAML 2.0 — set ACS URL and SP entity ID from our side; upload your IdP metadata
  • OIDC — register an app in your IdP; copy client_id/client_secret into our setup form

Test sign-in via a test user before enforcing for everyone.

Configure billing​

Tenant Settings → Billing → add payment method (card or invoice) → fill billing contact + tax ID.

→ Deep dive: Billing administration

Create initial workspaces​

Tenant Settings → Workspaces → New for each team. You'll appoint a workspace admin for each — they'll handle day-to-day management.

→ Concept: Workspaces, projects, tenants

Define RBAC​

Start with the built-in roles (tenant_admin, workspace_admin, member, guest). Add your own roles when you find a need — most orgs run on defaults forever.

→ Deep dive: RBAC overview

Next steps​