Certbot

From Newroco tech docs
Jump to: navigation, search

Certbot sets up a free Lets Encrypt certificate for your website. The following instructions are for Certbot which is the tool supplied by the EFF (the creators of Lets Encrypt) to help with setup. These notes are for a simple single site with defaults.

Ensure your server has a DNS record exists for the domain name(s) you will be using.

NB LetsEncrypt do not support wildcard certificates, but given it's no additional cost (and easy) to generate certs for different domains, or a cert will multiple domain names attached, wildcards are not a big issue.

Retrieve the certbot-auto script, make it executable, copy it somewhere in the default path and execute it:

  1.  
  2. wget https://dl.eff.org/certbot-auto
  3. chmod a+x certbot-auto
  4. cp certbot-auto /usr/bin/
  5. certbot-auto --apache

Follow the prompts displayed, making sure you enter the domain name(s) correctly. Given the current environment when asked about whether you want to have HTTP available it's recommended to take the "secure" option (HTTPS only).

If the certificate generates successfully, next configure auto-renew. Test this first by running

  1. certbot-auto renew --dry-run

and if successful add auto-renew to cron.daily

  1. sudo vim /etc/cron.daily/autorenew
  2.  
  3. #!/bin/sh
  4. ##script to run Lets Encrypt certificate renewal check/update tool
  5. certbot-auto renew --quiet --no-self-upgrade

and make it executable

  1. sudo chmod +x /etc/cron.daily/autorenew

You should occasionally run certbot-auto manually to let it upgrade, but the auto command will keep certificates updated in between.

Ubuntu 16.04

Certbot is packaged for 16.04, so apt-get the following package:

  1. $ sudo apt-get install python-letsencrypt-apache

It also has an Apache plugin that automates obtaining and installing certificates:

  1. letsencrypt --apache

You can also add domains manually, useful for adding aliases to a single certificate e.g. example.com & www.example.com

  1. letsencrypt --apache --domains example.com,www.example.com
  1. letsencrypt renew --dry-run --agree-tos

WARNING

There's a bug in the version of Certbot on Ubuntu Xenial which may show a warning saying 'Registering without email!' even if you have previously given an email to Certbot. Don't worry if this happens, it will not effect your renewal. If that appears to be working correctly, you can arrange for automatic renewal by adding a cron or systemd job which runs the following:

  1. letsencrypt renew