Troubleshooting

Solutions to common problems may be listed here.

Logging

By default, the daemon will output logging to the file at: /var/log/letsencrypt-cpanel.log. On CentOS 7+ logging is managed by systemd and can be accessed via

journalctl -u letsencrypt-cpanel -l

If you are experiencing any issues with the daemon, we recommend checking here first.

Any errors generated by the cPanel CGI plugin will be logged to: /usr/local/cpanel/logs/error_log
If you are experiencing any issues accessing or using the plugin from cPanel, check here first.

Symptoms and Solutions

Licence error when visiting the plugin page

Ensure that the daemon service is running:

service letsencrypt-cpanel status && service letsencrypt-cpanel restart

If the error persists, please run the technical support command on our contact page and email us at support@letsencrypt-for-cpanel.com.

Failed to issue certificate: The Let’s Encrypt HTTP challenge failed - is .well-known/acme-challenge accessible in your webroot?

First, you need to check that you can actually access http://your-domain.com/.well-known/acme-challenge . If you cannot, then the issue is likely an .htaccess rule blocking access. Try including the following lines at the top of your .htaccess file:

RewriteEngine On
RewriteRule ^.well-known - [L]

“The certificate could not be installed … Sorry the system admin has not enabled this feature”

Usually this means that a certain setting (allowcpsslinstall) is disabled. You may find this setting in WHM->Tweak Settings->Allow cPanel users to install SSL Hosts if they have a dedicated IP.

This setting is automatically changed during installation in version 0.4.3 and higher.

Rate limit error - too many certificates for this domain

Most likely, you have issued and deleted certificates of the same root domain too many times. These limits are quite low during the Let’s Encrypt beta period.

Rate limit error - too many registrations

The server may have hit a rate limit for too many new account registrations for a single IP address.

In this case, you should be able to proceed within 24 hours.

Icon not visible in cPanel

If the Let’s Encrypt icon is not visible in the cPanel list even though the link is present, this is most likely a caching issue. If forcing a refresh in your browser (Control+R) does not fix this, the plugin may need to be re-installed to refresh the cPanel icon cache for the plugin.