Use a custom domain
Point an already published Buda Site to a domain you own.
A published Site already has a Buda URL. Add a custom domain when you want the public address to use your brand, for example app.example.com.
The easiest path is to tell Buda what you want:
Bind this published app to
app.example.com.
Buda can bind the hostname and show the exact DNS record. You only need to copy that record into your DNS provider.
Before you start
- The Site must already be deployed or published.
- You need access to the domain's DNS settings.
- Use a subdomain first, such as
app.example.comorwww.example.com. It is the cleanest CNAME setup.
Connect the domain
Ask Buda to bind the domain
In the app's conversation, ask Buda to bind the published Site to your hostname, for example app.example.com. Buda will return the domain status and the CNAME target.
If you prefer the UI, go to Space settings -> Apps & Sites or Commander -> Sites, open the published Site's actions menu, choose Open details, then open Settings -> Custom domain.
Confirm the hostname
Use the full hostname, not just the root domain. Prefer app.example.com or www.example.com. If you are using the UI, enter the full hostname and click Bind domain.
Add the CNAME in DNS
In your DNS provider, add a CNAME record:
| Field | Value |
|---|---|
| Name / Host | The subdomain, such as app or www |
| Target / Value | The CNAME target shown in Buda, usually site-dns.budaapps.com |
Remove any conflicting A, AAAA, or CNAME record for the same host.
Add verification records if shown
Most setups only need the CNAME. If Buda also shows DNS ownership verification, add the shown TXT record exactly. If Buda shows HTTP ownership verification, copy the shown values exactly and serve the token from the current site before switching traffic.
Wait, then open the domain
DNS usually updates in a few minutes, but can take longer. Keep the domain bound in Buda while it updates. When it resolves, open https://your-domain from the Custom domain panel. Buda handles HTTPS automatically after validation.
Change or remove it
To change domains, remove the current custom domain first, then bind the new hostname. Buda only allows one custom domain per Site at a time.
For a root domain such as example.com, many DNS providers do not allow a normal CNAME. Use www.example.com or app.example.com, or use your DNS provider's ALIAS, ANAME, or CNAME flattening feature if available.
Quick fixes
| Problem | What to check |
|---|---|
| Bind domain is disabled | The Site is not deployed yet, or a custom domain is already bound. |
| Domain opens the old site | Remove conflicting DNS records and confirm the CNAME target matches Buda exactly. |
| HTTPS is not ready | Wait for DNS to resolve, then retry. Certificate setup starts after validation. |
| Need a different domain | Use Remove domain, then bind the new hostname. |