Custom domain
Point a subdomain you own, such as app.example.com, at a deployed app so its users see only your domain. Custom domains start on the Builder plan, with 1 domain per project.
The Free plan has only the <id>.manh.run subdomain. That address keeps working alongside your custom domain.
Add a domain
- Deploy the app at least once. The domain field only shows for a deployed app.
- Open Domain in the project sidebar, enter a subdomain such as
app.example.com, then click Add domain. - Where you manage DNS for the domain, create the two records the page shows: a
TXTrecord that proves you own the domain, and aCNAMErecord that points the domain at manh.run. - Wait until the status changes to Valid. The page checks again every minute, or click Check again.
The two records look like this (the real values are on the page, with a copy button next to each line):
_manh-verify.app TXT manh-verify=3f9c…
app CNAME <the target the page shows>Keep the TXT record after the domain is running.
Statuses
- Waiting for DNS, verification step: manh.run hasn’t found the right
TXTrecord yet. The domain doesn’t answer anything. - Waiting for DNS, certificate step: verified; waiting for the
CNAMEto take effect and the HTTPS certificate to be issued. The certificate usually arrives 1–2 minutes after DNS points the right way. - Valid: the app answers on your domain over HTTPS, UI and API alike.
- Invalid configuration: a DNS record is wrong; the reason shows below. Fix the record, then click Check again.
DNS can take up to 1 hour to take effect, depending on where the domain is managed. The domain starts answering only once verification and the certificate are both done, so users never hit a certificate error page.
Once the domain is running
- The app’s users never see manh.run: the UI, the API, file links and the tab icon all carry your domain and brand.
- Links in the e-mails the app sends use your domain, because the app’s
MANH_APP_URLfollows it. The sender name is the app’s name. <id>.manh.runkeeps answering as before.- Deploys and rollbacks keep the domain attached.
To remove it, click Remove next to the domain. The app stops answering on that domain at once, and e-mail links go back to <id>.manh.run.
Building the app for a client? Settings › Hand over lists what to finish before you hand it over, the custom domain included.
Good to know
- Use a subdomain (
app.example.com). To use the root domain (example.com), redirect it to the subdomain at your DNS provider. - Each project takes 1 domain. If one app needs several domains, redirect the others to the main one.
- When a paid plan expires and the 7-day grace period passes, the account returns to Free. The app keeps running at
<id>.manh.runand the custom domain is paused.
Next steps
- Plan limits — how many projects, requests and domains each plan gets.
- Logs and traffic — confirm requests reach the app through the new domain.