Custom domains

Every nebula gets a secured spaceport.host subdomain for free. Point your own domain at it whenever you're ready — SSL included.

1. Point your DNS

Create an A record for the domain you own, aimed at the Nebulae router:

app.example.com.   A   167.253.34.245

For an apex/root domain, use whatever A-record support your registrar provides (or a CNAME on a subdomain).

2. Add the domain

From the CLI:

$ nebula domain add app.example.com --nebula hello-spaceport
✓ vhost created · proxying app.example.com → hello-spaceport

Or from the nebula's dashboard page, under Domains.

3. Secure it

Once DNS resolves, request a certificate. Nebulae runs Certbot and reloads nginx for you:

$ nebula domain secure app.example.com
→ issuing certificate…
✓ https://app.example.com is live

Extra subdomains

You can also add nested subdomains under your project address — handy for splitting an API and a web front end across the same nebula:

$ nebula domain add api.hello.jeremy.spaceport.host --nebula hello-spaceport
Removing a domain takes down its vhost but leaves the certificate in place, so re-adding it later is instant.