Custom domains
Attach your own domain to a service ingress. TLS is provisioned automatically.
Every service with a public ingress gets a Simplifyd-assigned domain out of the box. You can replace this with your own domain — for example, api.example.com — by adding a custom domain to the ingress and updating your DNS records.
Prerequisites
- A service with at least one ingress configured.
- Access to your domain's DNS settings (through your registrar or DNS provider).
Adding a custom domain
- Click the service node on the canvas to open the service panel.
- Go to the Settings tab.
- Under the ingress entry, click Add Custom Domain.
- Enter the fully qualified domain name (e.g.
api.example.com). - Click Apply in the Apply Changes bar.
Simplifyd Cloud will display the DNS record you need to create.
Configuring DNS
After applying, the Settings tab shows a CNAME target — a hostname provided by Simplifyd Cloud. Create a CNAME record at your DNS provider pointing your domain to this target:
| Type | Name | Value |
|---|---|---|
CNAME | api (or your subdomain) | the Simplifyd-provided target |
DNS propagation can take a few minutes to several hours depending on your provider and TTL settings. Simplifyd Cloud continuously checks for the record and activates the domain automatically once propagation is detected.
CNAME records cannot be set on a root/apex domain (e.g. example.com itself) with most DNS providers. Use a subdomain such as www.example.com or app.example.com. Some DNS providers support CNAME flattening or ALIAS records for apex domains — check your provider's documentation.
TLS certificate
TLS is provisioned automatically once your DNS record is verified. You do not need to upload a certificate or configure anything manually. Certificates are renewed before they expire.
The domain status in the Settings tab shows one of the following:
| Status | Meaning |
|---|---|
| Pending | DNS record not yet detected |
| Verified | DNS record found; certificate provisioning in progress |
| Active | Domain is live and serving HTTPS traffic |
| Error | Verification failed — check your DNS record |
Multiple custom domains
You can attach more than one custom domain to a single ingress — for example, api.example.com and api.example.io. Repeat the steps above for each domain. All domains share the same ingress configuration and the same service port.
Removing a custom domain
- Open the service panel → Settings tab.
- Find the custom domain entry and click the trash icon next to it.
- Click Apply to confirm.
After removal, traffic to that domain will no longer reach your service. Delete or update the CNAME record at your DNS provider to avoid leaving a dangling pointer.
