START HERE FEATURE
Local Domain
A framework with tenancy should not be introduced through localhost forever. Register a stable local domain early and let the runtime behave like a product host.
Feature Guide
A quick orientation block that answers the essential questions: what this feature does, how it works, why it matters, and the key concepts behind it.
What this does
Register .test domains through the built-in local-domain helper instead of relying on ad hoc host setup.
Local Host Strategy
Make local URLs look like product hosts
Choose one `.test` base domain, register hosts through the Semitexa local-domain helper, and restart so the runtime resolves them predictably.
Step 1
Choose the base domain
Keep the local base memorable and stable. The common example is `semitexa.test`.
TENANCY_BASE_DOMAIN=semitexa.testStep 2
Register the browser hosts
Register both the main host and any tenant-specific host you plan to open during local work.
bin/semitexa local-domain:add semitexa.testbin/semitexa local-domain:add acme.semitexa.testbin/semitexa local-domain:listStep 3
Restart and open the host
After domain changes, restart once so the runtime, proxy, and DNS layer agree on the same environment.
bin/semitexa server:restarthttp://semitexa.testWhy Not /etc/hosts?
- The CLI-managed local-domain path is repeatable across projects and easier to inspect later with `local-domain:list`.
- It keeps the local proxy and DNS story in the same operator surface instead of splitting it between shell scripts and OS edits.
- It makes tenant hosts easier to add and remove as the project evolves.
Verified against Semitexa Ultimate 2026.09.19.1020
Local Domain
Serious tenancy work should happen on real local hostnames, not on endless localhost tabs.
Canonical flow
- Choose one stable
.testbase domain. - Register the main host and any tenant hosts through the Semitexa helper.
- Restart the runtime so DNS, proxy, and environment agree on one shape.
- Open the real host in the browser.
Commands
TENANCY_BASE_DOMAIN=semitexa.test
bin/semitexa local-domain:add semitexa.test
bin/semitexa local-domain:add acme.semitexa.test
bin/semitexa local-domain:list
bin/semitexa server:restart
Rules
- prefer one memorable
.testbase domain per project - use the CLI helper instead of manual host drift
- restart after meaningful DNS or environment changes
- verify tenant hosts in the browser, not only the raw port
Why this matters
Tenancy, cookie scope, domain routing, and absolute URL behavior become much easier to reason about when local development already behaves like a real product host.