Docs

SSL/TLS

How to give websites SSL/TLS certificates from the SSL/TLS section of the admin area, with free Automatic SSL certificates from Let's Encrypt or certificates bought from a certificate company.

10 min read Updated From the panel's guide

The SSL/TLS section of the admin area holds the tools for the certificates that let websites answer on https://. There are two kinds:

  • Free certificates from Let's Encrypt, requested and renewed by Automatic SSL. This is what most websites use.
  • Own certificates bought from a certificate company (for example an OV or EV certificate). You make a signing request, buy the certificate and install it on the website.

Clients can get and remove certificates for their own websites under SSL/TLS Certificates in their own area. The certificate of the panel itself and of the mail and FTP services are set under Network → Panel Certificate and Network → Service Certificates.

Automatic SSL#

In the admin area, open SSL/TLS → Automatic SSL (Automatic SSL). Automatic SSL gets free certificates for the domains of the hosting accounts and keeps them current.

The top of the page shows:

  • Provider in use: Let's Encrypt, or Disabled.
  • Account with the provider: the server's registration with Let's Encrypt, made at the first certificate request.
  • Next regular check: when the next run starts (server time). After that, a run starts every three hours. Each server runs at its own minute in the hour, so that not every server asks Let's Encrypt at once.

Check All Accounts Now starts a run at once instead of waiting. The progress shows below the button. The button is disabled while the provider is Disabled or while another long task runs (only one runs at a time).

Below are four tabs: Provider, Settings, Run Logs and Per Account, each described in its own section.

Good to know:

  • Accounts whose package leaves out the SSL/TLS feature do not get free certificates, unless you switch Automatic SSL on for them under Per Account.
  • Suspended accounts are skipped.
  • While Automatic SSL is disabled, certificates already installed stay and keep renewing.

How an Automatic SSL run works#

Automatic SSL (in the admin area under SSL/TLS → Automatic SSL, Automatic SSL) looks at every website of every covered account at each run and decides:

  • No certificate: a free certificate is requested.
  • Free certificate: it is renewed when less than a third of its lifetime is left (about 30 days for a 90-day certificate), or when it does not cover the website's domain. Otherwise the run notes "TLS status: OK" and the expiry date.
  • Own certificate (installed by the client or administrator): a self-signed certificate is always replaced. One that has expired, is not made for the domain, or expires within 3 days is replaced only when Let Automatic SSL also replace other certificates that are invalid or about to expire is on (Settings tab); otherwise the run gives a warning and leaves it. If getting the free certificate fails, the own certificate stays in use.

A certificate covers the domain itself, www. and mail. when they point to the same address (mail only when the mail server is installed), and the website's alias domains with their www. names when they point to this server. Up to 100 names per certificate; wildcards are not possible. Let's Encrypt checks each domain over HTTP, so port 80 must be reachable.

A domain that does not resolve to this server yet is put off (a warning) and tried again at the next run. Other failures are errors. New certificates use the key type set under SSL/TLS Protocols and Ciphers.

Automatic SSL Provider tab#

In the admin area, open SSL/TLS → Automatic SSL (Automatic SSL) and the Provider tab. Here you choose where the certificates come from:

  • Disabled: no new certificates are requested. Installed ones stay and renew.
  • Let's Encrypt™: free domain-validated certificates, valid for up to 90 days and renewed well before they end.

To use Let's Encrypt:

  1. Choose Let's Encrypt™.
  2. Read the provider's terms of service (the link on the page) and tick I accept these terms of service.
  3. Click Save.

If the provider changes its terms, the tab says so; accept the new terms to go on using it.

Once the server is registered, the tab also offers Register this server with Let's Encrypt™ again. This replaces the server's registration with a new one, and existing certificates are renewed with the new registration from then on. You do not need this to keep using the provider; use it only if the registration is broken or you want a fresh one. If registering fails, nothing is changed.

Automatic SSL Settings tab#

In the admin area, open SSL/TLS → Automatic SSL (Automatic SSL) and the Settings tab (Settings).

Messages to Account Owners and Messages to the Administrator each have four choices:

  • a notice for every Automatic SSL event, including normal successes;
  • a notice when a certificate request fails, gives a warning or is put off (the default);
  • a notice only when a certificate request fails;
  • no Automatic SSL notices.

Messages to account owners go to each account's contact address, when its owner switched on certificate notices under Password and Sign-in. Messages to the administrator go to the server contact address set under Alert Contacts. One message is sent per run, listing what happened per account.

Let Automatic SSL also replace other certificates that are invalid or about to expire. With this on, Automatic SSL also replaces certificates it did not issue: when an account's certificate from another authority is invalid or expires within 3 days, a free certificate is installed in its place. Self-signed certificates are always replaced, whatever this setting says.

Leave this off unless you are sure: an EV or OV certificate that is invalid or about to expire would be replaced by a DV certificate.

Click Save to store the settings.

Automatic SSL Run Logs tab#

In the admin area, open SSL/TLS → Automatic SSL (Automatic SSL) and the Run Logs tab (Run Logs). Every Automatic SSL run writes its own log; the newest 60 are kept.

To read a log:

  1. In Pick a run, choose a run. Each shows its start time and whether it covered all accounts or one account.
  2. Click Show Log.

The log lists, per account and website, what the run found and did: "TLS status: OK" with the expiry date, a certificate requested and installed (with the names it covers), accounts skipped (suspended, or Automatic SSL not enabled), and warnings and errors with their reason. Lines are marked SUCCESS, WARN or ERROR.

If the run is still going, the log says so; click Refresh to see more.

Common reasons for a failure are a domain whose DNS A record does not point at this server, or port 80 not reachable from the internet. Fix that and the next run tries again, or start one with Check All Accounts Now.

Automatic SSL Per Account tab#

In the admin area, open SSL/TLS → Automatic SSL (Automatic SSL) and the Per Account tab (Per Account). Here you choose, per account, whether Automatic SSL looks after it. Each account shows Covered or Not covered.

Each account has three choices:

  • Always on: on, whatever its feature list says.
  • Always off: off, whatever its feature list says. Certificates it already has stay.
  • As the feature list says: follows the SSL/TLS feature of the account's feature list or package; the page shows which list and whether it is enabled there.

To change accounts one by one, pick the choice in each row and click Save. To change several at once, tick them and click Switch On for the Ticked Accounts, Switch Off for the Ticked Accounts or Follow the Feature List for the Ticked Accounts. Use the search box to find accounts.

Check "account" in a row starts a run for that one account only; its log appears under Run Logs.

Installed Certificates#

In the admin area, open SSL/TLS → Installed Certificates (Installed Certificates). The page lists every website on the server with its account, its certificate (None, Own certificate or Free (Let's Encrypt)), the date it is valid until, and whether HTTPS is forced.

At the top it says how many websites have no certificate and whether automatic renewal of free certificates is on (the system's renewal timer is running) or off.

  • Get free certificates for all websites without one starts a full Automatic SSL run for every covered account. The progress shows on the page.
  • Run Automatic SSL in the row of a website without a certificate requests a free certificate for that website alone.

A free certificate can only be issued when the domain already points to this server and port 80 is reachable; otherwise you get a message saying why. Whether HTTPS is forced is set per website by the client (SSL/TLS Certificates in their own area). To remove certificates, use Certificate Store.

Certificate Store#

In the admin area, open SSL/TLS → Certificate Store (Certificate Store). The page lists the certificates stored on this server: for each website that has one, its account, its kind (Own certificate or Free (Let's Encrypt)) and the date it is valid until. Below the table it says how many websites have no certificate and are not listed.

To remove a certificate, click Remove in its row.

Good to know:

  • Removing a certificate turns HTTPS off for that website, unless an own certificate is removed and a free certificate issued earlier is still there: then the free one takes over again.
  • A removed own certificate and its key are gone; keep a copy if you may need it again.
  • If the account is covered by Automatic SSL, its next run gives the website a free certificate again. To stop that, switch the account off under the Per Account tab of Automatic SSL.

Create a Certificate Signing Request#

In the admin area, open SSL/TLS → Create a Certificate Signing Request (Create a Certificate Signing Request). A certificate company needs a signing request (CSR) to issue a certificate you buy.

  1. Choose the Website.
  2. Choose the Kind of key: RSA 2,048-bit (works everywhere), RSA 4,096-bit, ECDSA P-256 (smaller and faster) or ECDSA P-384.
  3. Optionally add More names for the certificate, separated by commas or spaces. The website and its www name are always included. More names must lie below the website's domain, such as shop.example.com; *.example.com asks for a wildcard.
  4. Fill in Country (two letters, such as PK), State or province, City and Organization, as the certificate company asks.
  5. Click Make the request.

The signing request appears on the page. Give this text to the certificate company. The matching private key is kept on the server, so when the certificate arrives, install it under Install a Certificate on a Domain and leave the key field empty.

Install a Certificate on a Domain#

In the admin area, open SSL/TLS → Install a Certificate on a Domain (Install a Certificate on a Domain). Use it for a certificate you bought from a certificate company.

  1. Choose the Website.
  2. Paste the certificate into Certificate, followed by the company's chain certificates, including the -----BEGIN CERTIFICATE----- and -----END CERTIFICATE----- lines, with the company's intermediate certificates after it.
  3. Paste the Private key, or leave it empty when the signing request was made on this server.
  4. Click Install.

The certificate is checked first: it must be valid today, be made for this domain and fit the key. If it passes, the website answers on https:// with it at once.

Good to know:

  • A certificate you install takes the place of a free one. Automatic SSL leaves it alone unless it is self-signed or, with the replacement option on, invalid or about to expire.
  • To go back to a free certificate, remove the own one under Certificate Store.
  • For a free certificate, use Automatic SSL instead.

SSL/TLS Protocols and Ciphers#

In the admin area, open SSL/TLS → SSL/TLS Protocols and Ciphers (SSL/TLS Protocols and Ciphers). This page sets the Key type for new SSL/TLS certificates: the kind of key new free certificates from Let's Encrypt (Automatic SSL) are made with.

  • ECDSA, P-256 (the default): small and fast, read by every current browser.
  • ECDSA, P-384.
  • RSA, 2,048-bit: for very old browsers and devices.
  • RSA, 4,096-bit.

Choose one and click Save. Existing certificates change to the new key type when they are next renewed.

The protocol versions and cipher list that Apache offers to browsers are set under Service Settings → Apache Configuration (Apache Configuration), in the SSL/TLS Protocols and SSL Cipher Suite settings. To work with all current browsers, keep TLSv1.2 on. The page also links to the panel's own certificate, Service Certificates, Installed Certificates, Certificate Store and Create a Certificate Signing Request.

Was this article helpful?

Something missing? Ask in the community or open a ticket.