Custom Domains
Point a CNAME or apex A record at your tenant, then systemprompt cloud domain set provisions TLS automatically. Track pending_dns to active with domain status.
On this page
Configure custom domains for your systemprompt.io Cloud deployment. TLS certificates are provisioned automatically.
Setting a Custom Domain
# Set your custom domain
systemprompt cloud domain set api.example.com
# Set apex domain
systemprompt cloud domain set example.com
DNS Configuration
After setting your domain, configure DNS records:
For Subdomains (Recommended)
Create a CNAME record pointing to your cloud tenant:
| Type | Name | Value |
|---|---|---|
| CNAME | api | your-tenant.systemprompt.cloud |
For Apex Domains
Create an A record pointing to the systemprompt.io IP:
| Type | Name | Value |
|---|---|---|
| A | @ | <provided-ip> |
The IP to use is shown when checking domain status:
systemprompt cloud domain status
TLS Certificate Provisioning
After DNS is configured, TLS certificates are automatically provisioned:
- systemprompt.io detects DNS propagation
- A certificate is issued and installed
- HTTPS is enabled automatically
Track progress with systemprompt cloud domain status.
Checking Domain Status
# View domain configuration and certificate status
systemprompt cloud domain status
Domain Status Values
| Status | Description |
|---|---|
pending_dns |
Waiting for DNS records |
provisioning |
Certificate being issued |
active |
Domain fully configured |
error |
Configuration failed |
Removing a Custom Domain
Removing the custom domain reverts the deployment to its default subdomain:
# Remove the custom domain (add -y to skip confirmation)
systemprompt cloud domain remove
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
pending_dns stuck |
DNS not propagated | Wait 24-48 hours, check with dig |
| Certificate error | DNS misconfigured | Verify CNAME/A record is correct |
| HTTPS not working | Certificate pending | Wait for provisioning, check status |
| Domain conflict | Domain already in use | Contact ed@systemprompt.io |
Checking DNS Propagation
# Check CNAME record
dig CNAME api.example.com
# Check A record
dig A example.com
# Check from multiple locations
dig @8.8.8.8 CNAME api.example.com
Quick Reference
| Task | Command |
|---|---|
| Set domain | systemprompt cloud domain set <domain> |
| Check status | systemprompt cloud domain status |
| Remove domain | systemprompt cloud domain remove |