mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-10-10 10:48:10 +02:00

Files

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

config

web: general domain cleanup (canonical/aliases normalization)

2025-09-19 14:51:56 +02:00

README.md

Nginx File Server

🔥 Description

The Nginx File Server role sets up a simple and secure static file server using Nginx. It provides an easy way to serve files over HTTPS, including directory listing, .well-known support, and automatic SSL/TLS certificate integration via Let's Encrypt.

📖 Overview

Optimized for Archlinux, this role configures Nginx to act as a lightweight and efficient file server. It ensures that files are served securely, with optional directory browsing enabled, and proper MIME type handling for standard web clients.

Key Features

HTTPS Secured File Hosting: Automatically retrieves SSL/TLS certificates using Let's Encrypt.
Autoindex Directory Listing: Displays files and folders in a clean and human-readable format.
.well-known Support: Fully supports ACME and other .well-known path requirements.
Customizable File Path: Easily adjust the root directory for your files through Ansible variables.
Local Time Display: Enhances directory listings by showing local timestamps.

🎯 Purpose

The Nginx File Server role is ideal for hosting static files, sharing resources internally or externally, and serving ACME challenges for certificate issuance. It offers a reliable and minimalistic alternative to more complex file-sharing solutions.

🚀 Features

Automatic SSL/TLS Certificate Management: Integrates with Let's Encrypt for secure access.
Simple Configuration: Minimal setup with clear, maintainable templates.
Directory Listings: Enables browsing through served files with human-readable file sizes and timestamps.
Static Content Hosting: Serve any type of static files (documents, software, media, etc.).
Well-Known Folder Support: Allows serving validation files and other standardized resources easily.