Tenant Onboarding #

Every organization in TsubameMail is an isolated Enterprise Tenant (TenantID) with strict data, directory, and credential isolation (ADR-0023).

Creating an Enterprise Tenant #

  1. Provision the enterprise record via POST /v1/enterprises:
json
{
  "tenant": "acme",
  "display_name": "Acme Corporation"
}
  1. Upon creation, TsubameMail automatically: - Registers the tenant directory namespace (tenant-configd). - Allocates and activates your default platform subdomain (acme.<base>, e.g., acme.mail.example.invalid) in verified state as the initial primary domain. - Records the onboarding event in the immutable audit chain.

Signing In to the Tenant Console #

  1. Open https://console.<your-domain> in your browser.
  2. Sign in with your Tenant Owner credentials (POST /v1/tenant/login using password or enrolled Passkey).
  3. Verify that your Tenant ID and default subdomain <slug>.<base> appear in the Domain & Organization Overview panel.
IMPORTANT

The Tenant Console (console.<your-domain>) derives the base domain dynamically from window.location.hostname and keeps session tokens strictly in memory. Closing or refreshing the tab clears the session token cleanly.