kevinveenbirkenbach/computer-playbook
1
0
Fork 0
mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-10-31 18:29:21 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
aa19a97ed62b7e79440e6ec324968e3e3e2d8fce
computer-playbook/roles/web-svc-html
History
Kevin Veen-Birkenbach a817d964e4 refactor(front-stack): introduce sys-stk-front-base and semi-stateless stack; improve coturn role docs 
- Extract common HTTPS + Cloudflare + handler bootstrap into new role sys-stk-front-base
- Update sys-stk-front-proxy, web-svc-cdn, web-svc-file, web-svc-html to depend on sys-stk-front-base
- Add new sys-stk-semi-stateless role combining front-base + back-stateless
- Update web-svc-coturn to use sys-stk-semi-stateless and rewrite README/meta with detailed Coturn description
- Unify sys-util-csp-cert README heading

Ref: ChatGPT conversation https://chatgpt.com/share/68d6cea2-3570-800f-acb3-c3277317f17b
2025-09-26 20:25:53 +02:00
..
config
…
meta
…
tasks
refactor(front-stack): introduce sys-stk-front-base and semi-stateless stack; improve coturn role docs
2025-09-26 20:25:53 +02:00
templates
…
vars
…
README.md
…

README.md

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