DNS
Custom Domains
Verify and manage custom domains for deployments with automatic SSL certificates.
Custom domains let you use your own domain with Vorynza deployments. Verification is CNAME-based with automatic SSL certificate issuance.
Adding a custom domain
Provide the hostname you want to use (e.g. app.example.com). Vorynza generates the
verification record you need to add to your DNS:
| Type | Name | Value |
|---|---|---|
| CNAME | app.example.com | A verification target unique to your domain |
Verification methods
| Method | Description |
|---|---|
cname | Add a CNAME record pointing to a Vorynza verification target |
txt | Add a TXT record with a verification token |
ns | Delegate the subdomain's nameservers to Vorynza |
CNAME verification is the default and recommended method.
Verification flow
- Add the custom domain from the dashboard
- Create the CNAME record at your DNS provider
- Vorynza resolves the CNAME and confirms the match
- Domain status changes to
active - SSL certificate is automatically issued and provisioned
- Edge route is synced to route traffic to your deployment
Custom domain statuses
| Status | Description |
|---|---|
pending | Domain added, awaiting DNS setup |
verifying | DNS check in progress |
active | Domain verified and SSL active |
failed | Verification failed after multiple attempts |
suspended | Domain suspended (billing or policy) |
SSL certificates
When a custom domain is verified, Vorynza automatically issues an SSL certificate and provisions it on the edge. Certificate statuses:
| Status | Description |
|---|---|
pending | Certificate request queued |
issuing | Certificate being issued |
active | Certificate active and serving |
failed | Certificate issuance failed |
API key access
Custom domains can be read programmatically using an API key with the dns:read scope.
Custom Domain API endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones/:zoneId/records | (implicitly domain records) |
GET | /api/orgs/:orgSlug/projects/:projectSlug/dns/domains | List custom domains |
POST | /api/orgs/:orgSlug/projects/:projectSlug/dns/domains | Add custom domain |
DELETE | /api/orgs/:orgSlug/projects/:projectSlug/dns/domains/:domainId | Remove custom domain |
Need help? Contact support.