Understand system domains
This reference explains the System Domains (CSV) field shown during server setup. Use it for administration hosts, not for public sites or Storefronts.
In this label, CSV means a comma-separated list of hostnames. The field is not a CSV file upload.
Enter system domains
Enter every hostname that should open the administration interface before a tenant is selected:
localhost,workspace.exampleUse hostnames only. Omit the scheme, port, path, and trailing slash.
| Incorrect | Correct |
|---|---|
https://workspace.example/ | workspace.example |
workspace.example/docs | workspace.example |
https://workspace.example:443 | workspace.example |
Keep tenant domains separate
A system domain identifies the global administration entry point. A tenant domain belongs to one tenant, is verified through DNS, and can bind to a public site with the cms_public surface.
| Host type | Purpose | Configuration |
|---|---|---|
| System domain | Administration interface before tenant selection | System Domains (CSV) during setup; comma-separated hostnames, no file upload |
| Tenant domain | Public site or Storefront for one tenant | Tenant-domain registration, DNS TXT verification, and site domain binding |
Do not add a Storefront host to System Domains (CSV) as a workaround. For the local Docker path, follow Set up a local storefront domain.
The Docker demo preconfigures its administration URL through NUCLEUS_PUBLIC_URL. You normally do not enter another system-domain list for localhost.alvine.dev during that guided setup.
Verify the result
The configuration is correct when the administration host resolves, its TLS certificate covers the hostname, and Workspace recognizes it as the global administration entry point. Public site hosts remain registered in their business tenants.
For production TLS and proxy configuration, continue with Server installation.