Platform subdomains and vanity URLs
4 min
Every Lunax site receives an instant vanity subdomain under .lunax.bond (or .lunax.ir). These subdomains are globally routed, secured by automatic wildcard TLS, and backed by high-speed Cloudflare edge infrastructure.
Checking availability
Before claiming a name, check whether your preferred subdomain is free:
``bash
lunax subdomain check myapp
This inspects the global registry in real-time. If the name is reserved for system use (such as api, admin, console, or billing`) or already claimed by another team, the CLI informs you immediately.
Claiming a vanity subdomain
Once you find an available label, bind it to your linked site:
``bash
lunax subdomain set myapp
This creates the ingress routing rule, provisions automated TLS certificates, and locks the subdomain to your project. Platform subdomains are immutable (locked: true`) once claimed to protect your production links against hostile takeover.
Viewing current hostname status
To inspect your active vanity subdomain and ingress state:
``bash
lunax subdomain get
`
It returns the active hostname, canonical URL, and TLS status
Platform subdomains vs custom domains
Platform subdomains require zero DNS configuration and serve traffic instantly. For vanity domains on your own apex or subdomain (e.g., app.example.com), use lunax domains add and set the provided CNAME record at your DNS provider.