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 #
- Provision the enterprise record via
POST /v1/enterprises:
json
{
"tenant": "acme",
"display_name": "Acme Corporation"
}- 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) inverifiedstate as the initial primary domain. - Records the onboarding event in the immutable audit chain.
Signing In to the Tenant Console #
- Open
https://console.<your-domain>in your browser. - Sign in with your Tenant Owner credentials (
POST /v1/tenant/loginusing password or enrolled Passkey). - 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.