Domains and data
Custom domains
Serve an app on your own domain, such as www.example.com. HTTPS is set up and renewed for you.
Add a domain
- Open the app, choose the Domains tab, enter the domain and choose Add domain.
- Add the two DNS records it shows at your domain's DNS provider (below).
- Wait. OceanLaunch checks by itself and the domain turns Live with HTTPS; the app is then deployed again with it.
An app can have up to 3 domains, and a domain can be on only one app. Wildcards and ports aren't supported.
The DNS records
1. Prove it's yours (TXT)
| Type | Name | Value |
|---|---|---|
| TXT | _oceanlaunch-challenge.www.example.com | oceanlaunch-verify=…
(copy it from the Domains tab) |
Many DNS providers want only the part before your domain in the name field:
_oceanlaunch-challenge.www.
Each app gets its own value. If the domain is still connected to another app (yours, or one of whoever had the domain before you), you can add it here all the same: it moves to this app as soon as this app's TXT record is visible, and the other app's owners are told by email. Whoever controls the domain's DNS decides where it goes.
2. Point it at OceanLaunch
- A subdomain such as
www.example.com: a CNAME record to your app's address, for examplebilling-api-acme.oceanlaunch.app. - The domain itself such as
example.com: A records with the IP addresses the Domains tab shows (or an ALIAS/ANAME record to your app's address, if your provider has that).
Remove any other A, AAAA or CNAME records for that name: the domain must point only at OceanLaunch.
Using Cloudflare? Set the record to DNS only (grey cloud), not proxied. Have a CAA record? It
must allow letsencrypt.org.
How long it takes
Usually minutes, sometimes up to 48 hours while DNS changes spread. OceanLaunch keeps checking for 3 days: often at first, then less often. Check now checks straight away and starts the 3 days again. The HTTPS certificate is issued on the first visit after the domain is live, and renews automatically.
Primary domain
Choose Make primary on a live domain, and every other address of the app (its
oceanlaunch.app address and its other domains) redirects there permanently, keeping the path and
query. Search engines then see one address. Stop redirecting undoes it.
- Java apps: applied within a minute, without a deploy.
- Static sites: applied with a quick redeploy.
Removing the primary domain also stops the redirects.