Custom Domains
Serve an application from your own domain, with automatic HTTPS.
By default an application is reachable at its outplane.app
URL. Attach a custom domain to serve it from
your own hostname instead, with HTTPS provisioned automatically.
Add a Domain
Enter the Host
On the Domains page, select Add domain and enter the bare host, such as
app.example.com. Do not include http:// or https://.
Connect It to an App
Choose an application and one of its HTTP or H2C ports. The path defaults to /,
which routes the whole host. You can leave the app empty to reserve the domain and
connect it later.
Point Your DNS
Open the DNS dialog. The console shows the exact record to create at your DNS provider:
- For a subdomain (
app.example.com), add a CNAME record. The console shows the name and the target value to copy. - For a root domain (
example.com), add an A record with name@and the value the console shows.
DNS changes take 5 to 30 minutes to propagate. HTTPS is issued automatically once the record resolves.
The path /.well-known/acme-challenge is reserved for certificate renewal and cannot be
used as a route.
Path Routing
A single host can route different paths to different applications. Add another path under
a host from the Path action. Each path must start with /.
Things to Know
- Custom domains work with HTTP and H2C ports only. A TCP port cannot take a custom domain.
- A domain is immutable once added. To change the hostname, delete it and add a new one. You can still change the bound app, port, and path.
- A new or changed route applies on the application's next deployment.