OceanLaunch docs

Build, ship and run your apps

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

  1. Open the app, choose the Domains tab, enter the domain and choose Add domain.
  2. Add the two DNS records it shows at your domain's DNS provider (below).
  3. 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)

TypeNameValue
TXT_oceanlaunch-challenge.www.example.comoceanlaunch-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

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.

Removing the primary domain also stops the redirects.