Skip to content

docs: document retry TLS action for failed custom domains #380

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: document retry TLS action for failed custom domains #380

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions applications/configure/custom-domains.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,3 +73,17 @@ Once the DNS record changes have been propagated, you will be able to attach the
Click on **Add Custom Domain**, input the custom domain you have just pointed to the load balancer, then hit deploy.

In a few minutes, you will be able to view the application on the custom domain, secured with an SSL certificate.

## Retrying a failed certificate

If certificate issuance fails for a custom domain (for example, because DNS had not propagated yet when the first attempt ran), the domain row in your application header shows a warning icon next to the hostname.

To retry issuance without redeploying the application:

1. Open the application and locate the failed domain in the header.
2. Hover or focus the domain. The warning icon swaps to a retry icon.
3. Click the domain to trigger a new certificate request.

The row shows a spinner while the request is in flight, then updates to the new certificate state — typically `pending` while cert-manager attempts issuance again, followed by the healthy state once the certificate is issued. The same retry control is available on preview environment domains.

<Info>Make sure the DNS record for the domain points at your load balancer before retrying. If DNS is still misconfigured, the next attempt will fail for the same reason.</Info>