Domains
Purpose
Section titled “Purpose”Explain how domains identify tenants and shape login.
Overview
Section titled “Overview”Each tenant has a unique domain (column on the tenants table). At login, an
omitted tenant_domain is resolved from the user’s email, falling back to the
platform DEFAULT_TENANT_DOMAIN. Tenants also carry SIP-specific domain
settings (SIP domain, WSS URI) used by the softphone, managed through the
sip-domains endpoints.
Configuration
Section titled “Configuration”DEFAULT_TENANT_DOMAIN=dev.get2dial.local# Web app build-time (baked into the JS bundle):NEXT_PUBLIC_CONTROL_API=https://api.get2dial.comExamples
Section titled “Examples”A user logging in without specifying a workspace is matched to their tenant by email; if their email exists in multiple tenants, the password disambiguates, and as a last resort the default domain is used.
NEXT_PUBLIC_*values are baked into the web image at build time — changing the public API URL requires rebuilding the image.- Keep DNS and the configured domain in sync so resolution and TLS issuance (ACME) succeed.