Files
computer-playbook/roles/web-svc-html
Kevin Veen-Birkenbach 97af4990aa refactor(webserver): rename roles and update references
- Rename sys-svc-webserver -> sys-svc-webserver-core
- Rename sys-stk-front-pure -> sys-svc-webserver-https
- Update includes, run_once flags, and docs across:
  * sys-ctl-mtn-cert-renew
  * sys-front-inj-*
  * sys-stk-front-proxy
  * sys-svc-certs
  * sys-svc-cln-domains
  * web-opt-rdr-*
  * web-svc-*
- Remove redundant webserver include in web-opt-rdr-www
- Fix documentation links

Ref: ChatGPT conversation https://chatgpt.com/share/68d6cea2-3570-800f-acb3-c3277317f17b
2025-09-26 19:34:42 +02:00
..
2025-07-09 05:00:41 +02:00

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.

🔗 Learn More

🧑‍💻 Author Information

Created in 2023 by Kevin Veen-Birkenbach