Troubleshooting SSL Errors on VergeCloud

If users encounter SSL errors while visiting your website and you are utilizing VergeCloud’s content delivery network (CDN), the issue may stem from several potential causes. This guide outlines common factors and steps to resolve them.

Common Causes of SSL Errors

• Disabled Cloud Icon: The cloud icon for your domain or subdomain's DNS record is disabled.
• Unconfigured SSL Certificate: The SSL certificate has not been configured in VergeCloud’s user panel.
• Invalid Certificate: An invalid SSL certificate was uploaded in VergeCloud’s user panel.
• Expired Certificate: The SSL certificate uploaded in VergeCloud’s user panel has expired.
• Non-Wildcard Certificate: A non-wildcard SSL certificate was uploaded in VergeCloud’s user panel, which cannot cover subdomains.

Resolving Disabled Cloud Icon

The cloud icon must be enabled for your domain's DNS records to activate VergeCloud’s CDN and its SSL features. Follow these steps:

1. Log in to the VergeCloud user panel.
2. Navigate to the CDN Product section and select your domain.
3. Go to the DNS Records section.
4. Locate the A records for your domain and ensure the cloud icon is enabled.
5. If the cloud icon is disabled, click it to activate the CDN for that record.

Verifying SSL Certificate Settings

Once the cloud icon is enabled for your primary domain, verify and configure your SSL certificate settings:

1. Go to the CDN Product section and select your domain.
2. Open the HTTPS Settings section.
3. Enable HTTPS for your domain.
4. Click on Personal Certificate and upload the necessary private key and SSL certificate files.

Using a Wildcard Certificate

If you need to secure both your primary domain and subdomains, ensure that a wildcard SSL certificate is uploaded. The certificate must meet the following requirements:

• It should be valid and not expired.
• It must be properly chained to ensure trustworthiness.
• It should cover both the primary domain and all subdomains.

Leveraging VergeCloud’s Free SSL Certificate

VergeCloud provides a free SSL certificate through Let’s Encrypt for seamless HTTPS configuration. To use VergeCloud’s free SSL certificate:

1. Navigate to the HTTPS Settings section for your domain in the VergeCloud user panel.
2. Enable HTTPS and click on Issuance Request.
3. The free SSL certificate will be issued for your domain and all associated subdomains.

Additional SSL Tips

For advanced SSL certificate management, refer to the following resources:

• Exporting the SSL Certificate and Private Key from cPanel
• How to Create a Chained Certificate Using a Browser
• Creating a Certificate Trust Chain

Considerations

• Ensure the cloud icon is enabled for all DNS records requiring VergeCloud’s SSL and CDN features.
• Use wildcard SSL certificates to secure subdomains efficiently.
• Regularly check the validity and expiration dates of your SSL certificates.
• For simple SSL configuration, VergeCloud’s free SSL certificate provides a reliable solution.