Implemented certbot for cloudflare\hetzner, optimized documentation and solved bugs

roles/nginx-serve-files/README.md

@@ -1,3 +1,35 @@
 # Nginx File Server
 
-This Ansible role configures an Nginx server to serve files.
+## 🔥 Description
+
+The Nginx File Server role sets up a simple and secure static file server using [Nginx](https://nginx.org/). It provides an easy way to serve files over HTTPS, including directory listing, `.well-known` support, and automatic SSL/TLS certificate integration via Let's Encrypt.
+
+## 📖 Overview
+
+Optimized for Archlinux, this role configures Nginx to act as a lightweight and efficient file server. It ensures that files are served securely, with optional directory browsing enabled, and proper MIME type handling for standard web clients.
+
+### Key Features
+- **HTTPS Secured File Hosting:** Automatically retrieves SSL/TLS certificates using Let's Encrypt.
+- **Autoindex Directory Listing:** Displays files and folders in a clean and human-readable format.
+- **.well-known Support:** Fully supports ACME and other `.well-known` path requirements.
+- **Customizable File Path:** Easily adjust the root directory for your files through Ansible variables.
+- **Local Time Display:** Enhances directory listings by showing local timestamps.
+
+## 🎯 Purpose
+
+The Nginx File Server role is ideal for hosting static files, sharing resources internally or externally, and serving ACME challenges for certificate issuance. It offers a reliable and minimalistic alternative to more complex file-sharing solutions.
+
+## 🚀 Features
+
+- **Automatic SSL/TLS Certificate Management:** Integrates with Let's Encrypt for secure access.
+- **Simple Configuration:** Minimal setup with clear, maintainable templates.
+- **Directory Listings:** Enables browsing through served files with human-readable file sizes and timestamps.
+- **Static Content Hosting:** Serve any type of static files (documents, software, media, etc.).
+- **Well-Known Folder Support:** Allows serving validation files and other standardized resources easily.
+
+## 🔗 Learn More
+
+- [Nginx Official Website](https://nginx.org/)
+- [Let's Encrypt](https://letsencrypt.org/)
+- [HTTP File Server (Wikipedia)](https://en.wikipedia.org/wiki/HTTP_File_Server)
+- [HTTPS (Wikipedia)](https://en.wikipedia.org/wiki/HTTPS)

roles/nginx-serve-files/meta/main.yml

@@ -1,3 +1,30 @@
+---
+galaxy_info:
+  author: "Kevin Veen-Birkenbach"
+  description: |
+    Configures an Nginx-based file server with HTTPS support, automatic SSL/TLS certificate retrieval, directory listing, and .well-known handling for secure static file hosting.
+  license: "CyMaIS NonCommercial License (CNCL)"
+  license_url: "https://s.veen.world/cncl"
+  company: |
+    Kevin Veen-Birkenbach
+    Consulting & Coaching Solutions
+    https://www.veen.world
+  min_ansible_version: "2.9"
+  platforms:
+    - name: Archlinux
+      versions:
+        - rolling
+  galaxy_tags:
+    - nginx
+    - https
+    - file-server
+    - static-files
+    - ssl
+    - letsencrypt
+    - automation
+  repository: "https://s.veen.world/cymais"
+  issue_tracker_url: "https://s.veen.world/cymaisissues"
+  documentation: "https://s.veen.world/cymais"
 dependencies:
-- nginx-https
-- git
+  - nginx-https
+  - git

roles/nginx-serve-files/tasks/main.yml

@@ -1,5 +1,5 @@
 ---
-- name: "include role for {{application_id}} to recieve certs & do modification routines"
+- name: "include role for {{application_id}} to receive certs & do modification routines"
   include_role:
     name: nginx-https-get-cert-modify-all
   vars: