Web-svc-file Role¶

Description: No description available

Variables¶

author: Kevin Veen-Birkenbach
description: Configures an Nginx-based file server with HTTPS support, automatic SSL/TLS certificate retrieval, directory listing, and .well-known handling for secure static file hosting.
license: Infinito.Nexus NonCommercial License
license_url: https://s.infinito.nexus/license
company: Kevin Veen-Birkenbach

Consulting & Coaching Solutions https://www.veen.world

min_ansible_version: 2.9
platforms: [{‘name’: ‘Archlinux’, ‘versions’: [‘rolling’]}]
galaxy_tags: [‘nginx’, ‘https’, ‘file’, ‘static-files’, ‘ssl’, ‘letsencrypt’, ‘automation’]
repository: https://s.infinito.nexus/code
issue_tracker_url: https://s.infinito.nexus/issues
documentation: https://docs.infinito.nexus

README¶

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.