orbitpush domains
Add, remove and list the domains your site is served on.
npx orbitpush domains add <host> [--primary]
npx orbitpush domains remove <host>
npx orbitpush domains list
Each command updates domain and aliases in orbitpush.json and the pull zone together, so editing the file and running deploy stays an alternative. The Custom domains guide walks through a full setup.
domains add
npx orbitpush domains add www.example.com # the first domain becomes the primary domain
npx orbitpush domains add example.com # later ones are aliases that redirect to it
npx orbitpush domains add example.com --primary # make an alias the primary domain
Adds the hostname to the pull zone, prints the DNS record to create, and waits until the record points to bunny.net. It checks again 10 seconds after each check, for up to 15 minutes. Then it gets a free SSL certificate, turns on HTTPS and writes the alias redirects.
If DNS takes longer, or you stop it with Ctrl+C, run the same command again later: it continues where it stopped.
Without a terminal it checks once, and exits with status 1 while the domain is not connected.
| Option | Description |
|---|---|
--primary |
Make the domain the primary domain once it is connected. The former primary domain becomes an alias that redirects to it. Until then it stays an alias, so visitors are never sent to a domain without HTTPS. |
A site can have one primary domain and up to 8 aliases.
domains remove
npx orbitpush domains remove example.com
Removes the hostname from orbitpush.json and the pull zone. A primary domain that still has aliases cannot be removed: remove the aliases first, or make another domain primary with orbitpush domains add <host> --primary.
The DNS record is yours to remove at your DNS provider.
domains list
npx orbitpush domains list
✔ www.example.com connected, primary domain
! example.com waiting for DNS: example.com CNAME my-site.b-cdn.net
Changes nothing. Shows each domain, whether it is connected, and the DNS record it still needs. It also lists hostnames on the pull zone that are not in orbitpush.json.
It exits with 1 while any domain is not connected, so a script can poll it.