mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2025-08-29 23:08:06 +02:00
Kevin Veen-Birkenbach
009bee531b
- Renamed role `srv-tls-core` → `sys-svc-certs` - Renamed role `srv-https-stack` → `sys-stk-front-pure` - Renamed role `sys-stk-front` → `sys-stk-front-proxy` - Updated all includes, READMEs, meta, and dependent roles accordingly This improves clarity and consistency of naming conventions for certificate management and proxy orchestration. See: https://chatgpt.com/share/68b19f2c-22b0-800f-ba9b-3f2c8fd427b0
Nginx Domain Setup 🚀
Description
This role bootstraps per-domain Nginx configuration: it requests TLS certificates, applies global modifiers, deploys a ready-made vHost file, and can optionally lock down access via OAuth2.
Overview
A higher-level orchestration wrapper, sys-stk-front-proxy ties together several lower-level roles:
sys-srv-web-inj-compose– applies global tweaks and includes.sys-svc-certs– obtains Let’s Encrypt certificates.- Domain template deployment – copies a Jinja2 vHost from srv-proxy-core.
web-app-oauth2-proxy(optional) – protects the site with OAuth2.
The result is a complete, reproducible domain rollout in a single playbook task.
Purpose
Provide one-stop, idempotent domain provisioning for Nginx-based homelabs or small production environments.
Features
- End-to-end TLS — certificate retrieval and secure headers included.
- Template-driven vHosts — choose basic or ws_generic flavours (or your own).
- Conditional OAuth2 — easily toggle authentication per application.
- Handler-safe — automatically triggers an Nginx reload when templates change.
- Composable — designed to be called repeatedly for many domains.
Credits 📝
Developed and maintained by Kevin Veen-Birkenbach.
Learn more at https://www.veen.world
Part of the Infinito.Nexus Project — licensed under the Infinito.Nexus NonCommercial License