Skip to main content

How to Review an AutoSSL Failure in WHM

You can identify and troubleshoot why an SSL certificate failed to issue or renew automatically using the AutoSSL tool in WHM. This process allows a Server Administrator to determine if a failure is due to a configuration error, a DNS issue, or a...

You can identify and troubleshoot why an SSL certificate failed to issue or renew automatically using the AutoSSL tool in WHM. This process allows a Server Administrator to determine if a failure is due to a configuration error, a DNS issue, or a certificate authority (CA) rejection.

Before you begin

You will need:

  • Root or administrative access to WHM

  • The specific domain name that failed to secure an SSL certificate

Reviewing AutoSSL failures

  1. Log in to WHM.

  2. Navigate to Hostname Setup > Manage AutoSSL.

  3. Select the account associated with the failing domain from the list.

  4. Click the Check button to trigger a manual check, or locate the specific domain in the list to view its status.

  5. Locate the failed domain and click the View button next to the "AutoSSL" status or the specific error icon.

  6. Review the provided log output. Look for specific error codes or messages from the Certificate Authority (CA).

Note: Common reasons for failure include "DNS_PROBE_FINISHED_NXDOMAIN" (DNS not pointing to the server), "CN_NOT_FOUND" (Common Name mismatch), or "CA_REJECTED" (The CA refused the certificate due to a policy violation).

Troubleshooting common issues

DNS Issues

If the logs indicate a DNS failure, verify that the domain's A record points to the correct server IP address.

Certificate Authority Rejection

If the CA rejects the certificate, ensure the domain is not on a "Certificate Transparency" blocklist and that the domain's ownership is clearly established.

Confirm the result

  • The AutoSSL logs will display a clear "Success" message or a specific, actionable error code if the process fails again.

  • Once the underlying issue (such as a DNS mismatch) is corrected, running the Check button in the Manage AutoSSL interface will result in a successful certificate issuance.

Limitations

This procedure only identifies the cause of the failure; it does not automatically fix underlying DNS or configuration issues. If a domain continues to fail after you have verified the DNS records, the issue may be with the Certificate Authority's validation of your specific domain.

Did this answer your question?