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.html
support.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.