Installation

The plugin is distributed in RPM form as part of a yum repository for CentOS and AlmaLinux.

Prerequisites

Root SSH access to WHM
i386 or x86_64 CentOS 7, CentOS 8, AlmaLinux 8, or Ubuntu 20.04.
WHM/cPanel of at least STABLE version or newer (CloudLinux and LSWS compatible)
nginx (via EasyApache 4) is not supported.

Please note: cPanel DNSONLY servers are currently NOT supported, please use our FleetSSL DNSONLY package instead.

Installation procedure

Install the licence file

Licence Type Instructions

Trial Users Trial users may ignore this step, as a 72-hour duration trial licence will be downloaded automatically for you.

Purchased Licence You will have received a licence file by email. Save your issued licence file as /etc/letsencrypt-cpanel.licence and chmod to 0400. If you received a file ending in .json, rename the file to letsencrypt-cpanel.licence.

If you are upgrading from a trial licence to a paid licence, save/overwrite the issued licence file as above. After installing a new licence file, you will need to restart the background service with the following command: service letsencrypt-cpanel restart

Licence Type	Instructions
Trial Users	Trial users may ignore this step, as a 72-hour duration trial licence will be downloaded automatically for you.
Purchased Licence	You will have received a licence file by email. Save your issued licence file as `/etc/letsencrypt-cpanel.licence` and chmod to 0400. If you received a file ending in `.json`, rename the file to `letsencrypt-cpanel.licence`. If you are upgrading from a trial licence to a paid licence, save/overwrite the issued licence file as above. After installing a new licence file, you will need to restart the background service with the following command: `service letsencrypt-cpanel restart`

Install the plugin:

Instructions for: CentOS, RHEL, AlmaLinux and other EL derivatives

wget https://cpanel.fleetssl.com/static/letsencrypt.repo -O /etc/yum.repos.d/letsencrypt.repo ;
yum -y install letsencrypt-cpanel

Instructions for: Ubuntu 20.04

wget -qO - https://cpanel.fleetssl.com/downloads/packaging.key | sudo apt-key add - ;
echo 'deb https://r.cpanel.fleetssl.com/ubuntu focal main' > /etc/apt/sources.list.d/fleetssl.list ;
apt-get update && apt-get -y install letsencrypt-cpanel ;

Post-Installation

If there are no problems, you should be able to run a successful self-test immediately afterwards:

le-cp self-test

[SELF-TEST] Can read config ............ SUCCESS.
[SELF-TEST] Can connect to daemon and check licence ............ SUCCESS.
[SELF-TEST] Can connect to Lets Encrypt ............ SUCCESS.
[SELF-TEST] Can talk to WHM API ............ SUCCESS.
[SELF-TEST] Can talk to plugin RPC ............ SUCCESS.

Testing the installation

Now that the installation is complete, you should be able to login to any cPanel server on that server, and see the “Let’s Encrypt™ SSL” icon on the home screen.

You should be able to immediately issue certificates, provided that the domain actually points to the server.