Custom Domains
Attach your own domain names to web services and static sites on Runsite. Each service can have one or more custom domains, all with automatic TLS provisioning via Let’s Encrypt.
Adding a domain
Section titled “Adding a domain”Open the service in the dashboard, go to Custom domains and add the hostname you want to use (for example app.example.com). The dashboard then shows you the exact DNS record to add at your registrar and walks you through verification.
DNS configuration
Section titled “DNS configuration”Point your domain at Runsite using one of these records:
| Use case | Record | Name | Value |
|---|---|---|---|
Root or apex (example.com) | A | example.com | Platform IP (shown in the dashboard) |
Subdomain (app.example.com) | CNAME | app.example.com | <your-service>.runsite.app (web) or <your-site>.runsite.site (static) |
The exact target value is shown in the Custom domain dialog when you add the domain — copy it from there to avoid typos.
Verification
Section titled “Verification”After the DNS records propagate, trigger verification from the same dialog. Runsite checks that the records resolve to the expected target. Once verified, TLS is provisioned automatically — no extra setup needed.
If verification fails, the dashboard shows the expected and actual DNS records so you can fix the mismatch.
Domain status
Section titled “Domain status”| Status | Description |
|---|---|
pending | Domain added, DNS not yet verified. |
verified | DNS verified, TLS provisioning in progress. |
active | Domain fully active with TLS. |
failed | Verification or TLS provisioning failed. |
Removing a domain
Section titled “Removing a domain”Remove a domain from the same Custom domains screen. Traffic to that hostname stops being routed to the service immediately; the certificate is revoked in the background.