Skip to content
Watasu Docs

Custom Domains

Every app gets a managed *.watasu.app URL. Production apps usually want their own.

Custom domains attach to public web processes — the ones named web or *-web. Watasu provisions and renews TLS certificates for you.

Add a domain

Section titled “Add a domain”
Terminal window
watasu domains:add www.example.com --app my-app

If your app has more than one public web process, point the domain at the right one:

Terminal window
watasu domains:add admin.example.com --process admin-web --app my-app

Watasu prints the DNS target you need to configure with your DNS provider — typically a CNAME record (or an ALIAS/ANAME for apex domains, depending on your provider).

Wait for verification

Section titled “Wait for verification”
Terminal window
watasu domains:wait www.example.com --app my-app

This blocks until DNS resolves correctly and TLS is provisioned. Once it returns, the domain is live.

Inspect

Section titled “Inspect”

List all domains on an app:

Terminal window
watasu domains --app my-app

Show details for one domain (status, target, attached process):

Terminal window
watasu domains:info www.example.com --app my-app

Remove

Section titled “Remove”
Terminal window
watasu domains:remove www.example.com --app my-app

Apex and wildcard domains

Section titled “Apex and wildcard domains”
  • Apex (example.com) — supported. Use ALIAS, ANAME, or your DNS provider’s apex flattening, following the target Watasu prints.
  • Wildcard (*.example.com) — supported. Powerful, but every subdomain under the wildcard now resolves to that one app, so plan accordingly.

TLS

Section titled “TLS”

TLS is managed end-to-end. You don’t upload certificates and you don’t renew them. As long as DNS keeps pointing at the right target, the certificate keeps renewing.