Playbook
Install Certbot
Certbot from the server's repositories, ready to obtain Let's Encrypt certificates.
Category
Web servers
Time limit per server
15 minutes
Temporary failures
Retried automatically, up to 2 times
Version
1.0
Supported systems
Ubuntu 22.04+, Debian 12+, RHEL-compatible 8+ (AlmaLinux, Rocky Linux, RHEL, CentOS Stream, Oracle Linux), Amazon Linux 2023+
When to use it
Before Configure Reverse Proxy, Configure Certificate Renewal or Check Certificate Renewal. It installs Certbot and requests no certificate.
This playbook has no options.
What it does on the server
- On the RHEL family, enables EPEL, where Certbot is packaged.
- Installs
certbotand OpenSSL from the server's repositories. Acertbotthat did not come from the server's packages, such as a snap, is used as it is. - Checks that
certbotruns.
The nginx plugin is deliberately not installed: it rewrites nginx's configuration, which Configure Reverse Proxy manages. Certificates are obtained with the webroot method instead, which serves the Let's Encrypt check file from a folder and changes nothing else.
After the run
Run Configure Reverse Proxy to obtain a certificate and serve your site over HTTPS, or use the Nginx Reverse Proxy + Auto-Renewing SSL template, which runs all of these in order.
Common problems
"Certbot is not available from this server's repositories." — The server's configured repositories do not include Certbot, which can happen on Amazon Linux 2023. Nothing was changed. Use an Ubuntu, Debian or RHEL-family server for HTTPS with this platform, or install Certbot on this one another way; the other certificate playbooks then use it.