commit 87755ef08ebdd35ad2bea7321207ccf4d63b5860 Author: Michael Hettwer Date: Thu Mar 12 12:39:58 2026 +0100 Init diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..4613bd1 --- /dev/null +++ b/readme.md @@ -0,0 +1,37 @@ +# Certbot + +## Features + + - Installs & Configures certbot automatically on one or hundred of hosts. + - Works well with Apache or NGINX + - Integrates with FreeIPA + - Can be combined with our Ansible roles (lsa.webserver, lsa.freeipa,lsa.wordpress) for easier handling + - For easier handling helper scripts for each cert are generated + - Ansible facts are saved on Host, set certbot_facts to true (Python3, Pipx, Pyyml will be installed) + - Small Readme is generated on Host (default /etc/ansible/readme) set certbot_readme to true + +## Tasks + +### Basic Installation via Playbook + +```yaml +- name: "certbot" + + hosts: all + become: True + + roles: + - certbot +``` + + +## Inventory Defaults + +We define the certs in our inventory like this: + +```yaml + certbot_vhosts: + name: "domain.com" + alias: + - "www.domain.com" +``` \ No newline at end of file