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
- Verify your primary domain — adds a TXT record to prove ownership
- Configure SSO — connect your IdP (Okta, Google Workspace, Azure AD, OneLogin)
- Set up billing — payment method, billing email, tax ID
- Create initial workspaces — typically one per team
- Invite admins — promote 1-3 trusted people to tenant admin
- Define RBAC roles — start with the defaults, add your own roles later
- Configure security policies — MFA enforcement, session timeout, password rules
- 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