Reference
Hostnames and DNS
The generated hostname rule, the labels Kuppit reserves, and the exact records a custom domain takes.
Hostnames and custom domains explain; this page states.
Generated hostnames
[<environment>-]<project>[-<service>]-<id>.kuppit.app
| Part | Rule |
|---|---|
environment | The environment's slug, present for every environment except Production. A preview's is pr-<number>. |
project | The project's name, lowercased; runs of anything but letters and digits become one hyphen; leading and trailing hyphens dropped; at most 55 characters. |
service | The service's name, omitted when it is web. |
id | Six hexadecimal characters derived from the service. Unique per service, stable for its life. |
| Whole label | At most 63 characters. The environment prefix and the id are kept whole; the project and service part is what gets shortened. |
| Collision | -2, -3, … appended to the label. |
| Assigned | When the service is created. Answers once the first deployment is Live. Never changes, cannot be edited or removed. |
Reserved labels
A project can never produce a hostname starting with www, api, app, dashboard, status, docs, support, admin or mail, nor one shaped pr-<number>-. A project that would gets -2 appended.
Custom domain records
| Purpose | Type | Name | Value |
|---|---|---|---|
| Ownership | TXT | _kuppit-verification.<hostname> | The token shown on the Domains tab |
| Routing, subdomain | CNAME | <hostname> | domains.kuppit.app |
| Routing, root domain | ALIAS / ANAME / flattened CNAME | <hostname> | domains.kuppit.app |
Ownership is proved by the TXT record only. There is no A record to create: Kuppit has no fixed address.
What a custom hostname may be
| Accepted | Refused |
|---|---|
A registrable domain or a subdomain of one: example.com, app.example.com, example.co.uk | A wildcard: *.example.com |
| Internationalised names, stored as their ASCII form | An IP address |
| A bare public suffix | |
Anything under kuppit.app | |
| A hostname attached to any other service on Kuppit | |
| A hostname removed within the last 24 hours |
Hostnames are unique across all of Kuppit. A removed hostname is held for 24 hours before anyone, including its previous owner, can attach it again.
Timing
| Check | Interval |
|---|---|
| While ownership, routing or the certificate is pending | Every minute; Check DNS asks now. |
| After a certificate failure | Every 10 minutes. |
| Once Active | Every 15 minutes. |
| Routing withdrawn on removal | Two minutes to propagate before the certificate is removed. |
Was this page helpful?