GoAdmio

installssl

Install Certbot (the Let's Encrypt client) and its Apache or Nginx plugin

On this page: Overview · Quick start · Syntax · Options · Output · Examples · Troubleshooting · Details · See also


Overview

/go/installssl installs the software GoAdmio needs to get free SSL certificates from Let's Encrypt: Certbot and the Certbot plugin for the web server in use (Apache or Nginx).

It installs the tools only. It does not request a certificate. To get a certificate for a domain, use ssl after this command has run.

The command reads the operating system and the web server from GoAdmio's settings and picks the right packages:

OS Web server Packages
AlmaLinux, Rocky, CentOS, Red Hat, Fedora Apache mod_ssl, openssl, certbot, python3-certbot-apache
AlmaLinux, Rocky, CentOS, Red Hat, Fedora Nginx mod_ssl, openssl, certbot, python3-certbot-nginx
Debian, Ubuntu Apache certbot, python3-certbot-apache
Debian, Ubuntu Nginx certbot, python3-certbot-nginx

Quick start

/go/installssl

Syntax

/go/installssl

The command takes no arguments. Run it as root, because the Debian and Ubuntu steps don't use sudo.


Options

None.


Output

The command shows the progress message Installing Let's Encrypt and then the output of dnf or apt. It prints no message when it finishes, and it doesn't check whether the installation worked.

On an operating system that isn't listed above, it does nothing and prints nothing more.

Every run is logged to /var/log/go/installssl.log with a timestamp and the arguments used.


Examples

# Install Certbot and the plugin for your web server
/go/installssl
# Check that it was installed
certbot --version
# Then get a certificate for a domain
/go/ssl example.com

Troubleshooting

Symptom Likely cause Fix
No match for argument: certbot on AlmaLinux, Rocky, or CentOS Certbot comes from the EPEL repository, which isn't enabled. Run dnf install epel-release, then run the command again.
Could not get lock /var/lib/dpkg/lock Another package manager (such as automatic updates) is running. Wait for it to finish, then run the command again.
Permission denied on Debian or Ubuntu The command wasn't run as root. Run it as root.
A dialog asks questions on Debian Only the Ubuntu steps run apt in non-interactive mode. Answer the questions, or run export DEBIAN_FRONTEND=noninteractive first.
Nothing happens The operating system isn't one of the supported ones. Install Certbot by hand.
The command finished but there is no certificate This command doesn't request certificates. Use ssl.
Existing certificates are missing after the command On Debian and Ubuntu, the old Certbot packages are purged before they are installed again. Check /etc/letsencrypt. Back it up before you run the command on a server that already has certificates.
Certificates don't renew This command doesn't set up renewal. Check how renewals are scheduled (see cron and checkssl).

Details

  1. Loads GoAdmio's helper functions from /go/function and shows the progress message.
  2. Reads the operating system (os.db) and the web server (ws.db).
  3. On AlmaLinux, Rocky, CentOS, Red Hat, and Fedora, installs mod_ssl and openssl, then Certbot with the plugin for Apache or Nginx. mod_ssl is Apache's SSL module, so on an Nginx server it can bring in the Apache (httpd) package.
  4. On Debian and Ubuntu, runs dpkg --configure -a to finish any interrupted installation, purges the Certbot packages, and installs them again.

Because of the purge, running the command again on Debian or Ubuntu replaces the Certbot packages each time.

Item Used for
/go/function Shared helper functions, including the progress message.
/usr/local/goadmio/linux/os.db, ws.db The operating system and the web server.
/etc/letsencrypt Where Certbot keeps its accounts and certificates.
/var/log/go/installssl.log The command log.

See also

Command Description
ssl Install an SSL certificate for a domain in GoAdmio
checkssl Check if SSL certificates are installed for all domains
mailssl Install SSL certificates for SMTP and IMAP
openssl Generate, install, or delete a paid SSL certificate
zerossl Install a ZeroSSL certificate via the command line
https Redirect HTTP to HTTPS in GoAdmio
package Install all base packages required by GoAdmio