Web-svc-html Role¶
Description: No description available
Variables¶
author: Kevin Veen-Birkenbach
description: Configures an Nginx server to host static HTML websites with HTTPS support, automatic SSL certificate retrieval via Let’s Encrypt, and secure default settings.
license: Infinito.Nexus NonCommercial License
license_url: https://s.infinito.nexus/license
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’, ‘static’, ‘html’, ‘letsencrypt’, ‘ssl’, ‘homepage’, ‘automation’]
repository: https://s.infinito.nexus/code
issue_tracker_url: https://s.infinito.nexus/issues
documentation: https://docs.infinito.nexus
README¶
Nginx Static HTML Server¶
🔥 Description¶
This role configures an Nginx server to host a static HTML homepage securely over HTTPS. It automates domain configuration, SSL/TLS certificate retrieval using Let’s Encrypt, and ensures your site is ready for production with minimal setup.
📖 Overview¶
Optimized for Archlinux environments, this role provides a lightweight,
reliable solution for serving static websites. It automatically
configures Nginx to serve files from a predefined directory, sets up
secure HTTPS connections, and includes support for .well-known paths
required by ACME challenges.
Key Features¶
Static Site Hosting: Serves HTML, CSS, JavaScript, and other static files.
Let’s Encrypt Integration: Automatically requests and installs SSL/TLS certificates.
Simple Root Configuration: Defines a clean webroot with
index.htmlsupport.Secure by Default: Includes modern SSL headers and best practices via Nginx.
.well-known Support: Ensures full ACME challenge compatibility.
🎯 Purpose¶
The Nginx Static HTML Server role provides a simple and efficient method to publish static websites with HTTPS, perfect for personal homepages, landing pages, or small projects.
🚀 Features¶
Automatic HTTPS Certificates: Handles secure certificate issuance via Let’s Encrypt.
Minimal Nginx Setup: Clean and optimized default configurations.
Highly Portable: Works out-of-the-box with minimal variables.
Local Time Support: Properly displays directory listing timestamps when needed.