Files
computer-playbook/roles/web-svc-html
kevinveenbirkenbach 6efde55647 refactor(dashboard): rename web-app-desktop to web-app-dashboard and update service toggle
* replace compose.services.desktop with compose.services.dashboard across all roles
* rename role web-app-desktop to web-app-dashboard
* rename sys-front-inj-desktop to sys-front-inj-dashboard
* update resolver mapping to include web-app-dashboard when dashboard is enabled
* adjust CSP filters to reference dashboard for frame-ancestors handling
* update lookup plugins, filter plugins, templates, vars and run_once flags
* migrate all tests to dashboard naming and service key
* update role dependencies and port mappings
* remove legacy desktop role and variables

BREAKING CHANGE:
The service key compose.services.desktop has been renamed to compose.services.dashboard.
All custom configs, inventories, or overrides must be updated accordingly.

https://chatgpt.com/share/698da7ad-1978-800f-82b4-4755b17be026
2026-02-12 11:12:49 +01:00
..
…

NGINX 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