When it comes to making HTTPS available for everyone, the Let’s Encrypt project is great; however, if you’re running a shared host and you have an add-on domain, then there may be a problem with trying to install certificates for each of the sites.
Fortunately, many cPanel installations have an option for installing certificates by Let’s Encrypt.
But what happens when you try to install a certificate, and you see the following error message?
There was a problem installing the certificate. Please contact support for more information.
Depending on your set up, you may never see this message. But if you’re working within a shared hosting environment or you’re trying to configure a certificate for a set up with an add-on domain, then there’s a specific way to resolve this.
A Problem Installing the Certificate
If you’re used to basic server administration, then installing a certificate from Let’s Encrypt via the command-line isn’t terribly difficult.
If on the other hand, you’re inheriting a site, set up, or configuration where you have to work with cPanel and a shared host, then it may be faster (and easier) to use an option within cPanel itself.
Whatever the case, seeing a generic error message can be frustrating. In my experience, I’ve only seen this happen once, and it was under a very specific set of circumstances.
- Migrate a Site. This is usually the easiest part especially if the site doesn’t even need migrating (perhaps it’s already installed). This would also include pointing the DNS records to the new host and waiting for propagation to complete.
- Issue a Certificate. Use the cPanel option for installing and issuing the new certificate. This usually takes less than a minute and receive a success message.
- Create an Add-On Domain. At this point, you’re ready to migrate a new site as an add-on of the existing account. You create the add-on domain, migrate the file, update the DNS records, and wait for propagation to complete.
- Issue a Certificate. Once the previous step is done, you attempt to issue the certificate just like in the second step but it doesn’t work, and you’re presented with an error message.
So what gives?
In my case, it had to do with a conflict of the
.htaccess file that exists within the primary domain (or the
.htaccess file in the root of the account) that was causing a conflict.
The fix is just as easy as installing the certificate itself:
- Temporarily rename
.htaccessin the root of the primary domain.
- Issue the certificate for the add-on domain via cPanel.
- Restore the original
.htaccessfile in the root of the primary domain.
And that should take care of the problem. If you attempt to do this before DNS propagation has completed, then you may be presented with a different.
Assuming that you find yourself in the above position with an add-on domain and the inability to install the certificate, then following the steps above should resolve the problem.