Troubleshooting
A domain is stuck
What each domain status means, the sentences a domain shows, and when to press Check again.
Updated
Each domain on the Domains page has a status chip, and when something is wrong, one sentence in red on its card and at the top of its Show DNS records dialog. Start from the chip.
What the status means
| Status | What Cloud is doing | How long it tries |
|---|---|---|
| Waiting for DNS | The domain was added and its first check has not run. | The first check runs within a minute. |
| Checking DNS | Cloud is looking up the records. For your own domain it wants the TXT record and address records exactly as Show DNS records lists them. | Every five minutes, up to 12 times: about an hour. |
| Preparing HTTPS | DNS is right, and Cloud is waiting for the certificate. | The first three looks are a minute apart, then every five minutes, up to 12 in all. |
| HTTPS active | The domain serves your service over HTTPS. Cloud watches the certificate and checks its renewal. | Until you remove the domain. |
| DNS needs attention | DNS checks ran out. | Never again on its own: press Check again. |
| HTTPS needs attention | The certificate did not arrive, or a renewal failed and the certificate expired. | Never again on its own: press Check again. |
While a deployment of the service runs, checks wait and resume after it.
A failed domain is not checked again on its own
Once a domain reads DNS needs attention or HTTPS needs attention, Cloud stops checking it. After you correct the records, press Check again, the icon button on the domain's card, which starts a fresh round of checks. Pressing it while a domain is still being checked changes nothing.
Messages on a domain
When adding or renaming a domain
| Message | Why | What to do |
|---|---|---|
| Domain ingress is not configured on this platform. | The platform has no public address for domains yet. The page says "Domain connections are unavailable until the platform ingress is configured." | No domain can be added for now. Contact support if you need one. |
| Platform domains are not configured on this platform. | Generated and chosen names on the platform's domain are not available. The page says "Platform domains are not configured. You can connect your own domain when platform ingress is available." | Add your own domain under Your own domain, if the platform allows it. |
| Use a generated platform domain for this hostname. | You entered a hostname on the platform's own domain as Your own domain. | Choose Platform domain and type only the name before the platform's domain. |
| Host is invalid | The Hostname is not a valid domain name. | Type the full hostname, such as app.example.com, without https:// or a path. |
| Host is already in use | Another domain on the platform already has this hostname. | Remove it where it is added, or choose another hostname. |
| This hostname is already in use. | The same, when two additions happened at once. | Choose another hostname. |
| Use 3 to 63 lowercase letters, digits or hyphens, starting and ending with a letter or digit. | The platform Name does not fit the rule. | Choose a name such as shop-api. |
| That name is kept for Cahaves. Choose another. | The name is one Cahaves keeps, such as www, api, admin or login. | Choose another name. |
| That name is already in use. Choose another. | Any customer's domain already has this name. | Choose another name, or leave Name empty for a generated one. |
| Choose a port from 1 to 65535. | The Port for a compose service is missing or out of range. | Give the port that compose service listens on. |
| Only a domain on the platform's own can be renamed. Add your own domain instead. | Change name works on platform domains only. | Remove your own domain and add the new hostname. |
Visit is greyed out
A running application's Visit button says why it is greyed out:
| Label | What to do |
|---|---|
| Deploy it again and its domain is generated | The application has no domain, and the platform generates one after a successful deploy. Press Deploy. |
| Add a domain to visit this service | The service has no domain. Add one with Add domain. |
| Its domain is still being set up | Wait for HTTPS active, following the statuses above. |
| Its domain needs attention | A domain reads DNS needs attention or HTTPS needs attention. Fix it as above. |
If the domain reads HTTPS active but the page shows an error, the service is not answering on its port: see The service keeps restarting. For adding domains and their records, see Domains.