xoxys.certbot/index.md
Robert Kaussow 059397345e commit 1987e2bc95
Author: Robert Kaussow <mail@geeklabor.de>
Date:   Thu Jun 4 15:15:58 2020 +0200

    fix link to the license file
2020-06-04 13:29:59 +00:00

3.6 KiB

title type
certbot docs

Source Code Build Status License: MIT

Setup certbot Let's Encrypt client.


Default Variables

certbot_bin

Location of the certbot binary. Default is to ~/.local/.bin/certbot.

certbot_command_arguments

Default value

certbot_command_arguments:
  - certonly

certbot_config_dir

Default value

certbot_config_dir: /etc/letsencrypt

certbot_credentials

Specify key value parairs for your credentials (e.g. plugin credentials). The credentials will be saved to {{ certbot_config_dir }}/credentials.ini and you could add the path to certbot_command_arguments` if required.

Default value

certbot_credentials: []

certbot_cron_enabled

Enable scheduling via cron.

Default value

certbot_cron_enabled: true

certbot_cron_file

Use a file under /etc/cron.d but this will only work if certbot_user

Default value

certbot_cron_file: _unset_

Example usage

certbot-letsencrypt

certbot_cron_hour

Default value

certbot_cron_hour: '3'

certbot_cron_minute

Default value

certbot_cron_minute: '30'

certbot_domain_groups

Default value

certbot_domain_groups:
  - name: example
    domains:
      - '*.example.com'
      - example.com
    init: false

certbot_email

Default value

certbot_email: mail@example.com

certbot_log_dir

Default value

certbot_log_dir: /var/log/letsencrypt

certbot_packages_extra

Extra packages to install with pip (e.g. DNS plugins).

Default value

certbot_packages_extra: []

certbot_pip

Default value

certbot_pip: pip{{ ansible_python.version.major }}

certbot_preferred_challenges

Default value

certbot_preferred_challenges: dns

certbot_rsa_key_size

Default value

certbot_rsa_key_size: 4096

certbot_server

Default value

certbot_server: https://acme-v02.api.letsencrypt.org/directory

certbot_user

Default value

certbot_user: root

certbot_work_dir

Default value

certbot_work_dir: /var/lib/letsencrypt

Dependencies

None.