Homelab as-code · minfra-v2

Documentation, runbooks et wizard de déploiement.

Toute la vérité du homelab, validée au fur et à mesure du redéploiement. Édite n'importe quel .md ou .yml directement depuis le site — les modifications atterrissent dans le repo Git.

Documentation validée

Voir tout →
00 draft

Clé USB multi-boot Ventoy (Proxmox + Win11 + Debian)

Construction d'une clé USB unique bootant N ISOs au choix (Proxmox VE, Windows 11 unattended, Debian 13). Étape zéro DR — remplace le flash mono-ISO.

non validé 00-cle-multiboot-ventoy.md
01 draft

Poste admin Windows 11 — clé USB unattended

Reconstruction du poste d'admin minfra-v2 : flash d'une clé USB Windows 11 100% automatique (autounattend.xml). Étape zéro avant toute installation d'outillage.

non validé 00-poste-admin-win11.md
02 draft

Prérequis & Contexte

Contexte du homelab minfra-v2 + installation outillage poste d'admin (mise, task, terraform, packer, ansible, sops, age, bw).

non validé 00-prerequis-contexte.md
02 draft

Switches TP-Link — VLAN config salon + garage

Topologie réseau homelab avec 2× TP-Link TL-SG108PE (salon + garage). Trunk inter-sites Cat6 vlan natif 1 = LAN + tagged 20 WAN + tagged 30 DMZ. Box SFR isolée vlan 20 (WAN OPNsense).

validé 2026-05-21 02-switches-vlan-tplink.md
03 draft

Câblage — alimentation & réseau

Plan physique homelab : alimentation UPS, trunk inter-sites Cat6, ports switches TP-Link/Netgear et LAG NAS jedha.

non validé 01-cablage.md
04 draft

Proxmox coruscant — Setup smart

Bootstrap hyperviseur Proxmox VE sur coruscant (10.0.1.30) : SSH key minfra, repos no-subscription, no-nag patch, tokens API Packer+Terraform, storage NFS jedha, network bridge. Idempotent.

non validé 04-proxmox-setup.md
05 draft

NAS jedha — Setup smart

Bootstrap NAS Synology jedha (10.0.1.20) : SSH key admin, création structure /volume1/data (apps, backups, ISOs, secrets), export NFS pour Docker hosts DMZ. Idempotent.

non validé 05-nas-jedha-setup.md
06 draft

Template Debian 12 — build Packer

Build template Proxmox Debian 12 (VM 9100) avec Docker + NFS jedha mount baked. Cloné par Terraform pour créer VMs tatooine/kamino/kalevala.

non validé 06-template-debian12.md
07 draft

Template OPNsense 26 — build Packer

Build du template Proxmox OPNsense 26.1 via Packer avec stratégie inline (boot_command VNC). Produit template-opnsense26 (VM 9200) prêt à cloner par Terraform.

non validé 07-template-opnsense.md
08 draft

VMs Terraform — clone depuis templates

Déploiement des VMs minfra-v2 via Terraform : OPNsense (200), tatooine (130 platform), kamino (131 GitLab), kalevala (132 monitoring). Clone des templates Packer 9100/9200.

non validé 08-vms-terraform.md
09 draft

OPNsense — Config automatique (firewall, NAT, DHCP, DNS, WG)

Configuration complète OPNsense via Ansible : firewall, NAT outbound, port forward, DHCP Kea, Unbound DNS, WireGuard. Toutes les règles préfixées '🤖 minfra:' pour identifier l'automation IaC.

non validé 08-opnsense-config.md
10 draft

NFS mount sur VMs DMZ

Mount jedha:/volume1/data → /mnt/nas sur les hosts Docker DMZ (tatooine). Permet aux containers d'accéder aux volumes persistants stockés sur NAS.

non validé 10-nfs-mount-vms.md
11 draft

Platform Docker tatooine

Déploiement de la stack platform sur tatooine : step-ca (PKI), Traefik (reverse proxy interne), Authentik (SSO OIDC), Vaultwarden (secrets), Portainer (UI Docker), vision (dashboard).

non validé 11-platform-docker.md
11 validated

Tatooine — Rebuild complet from zero

Reconstruction complète VM tatooine (Platform Docker DMZ 10.0.2.10) avec template Debian 100GB. Détruit l'existant, rebuild template Packer, redeploie VM via Terraform, déploie tous services Docker (pki/Traefik/Authentik/Vaultwarden/Portainer/Vision/Hors-jeu/Holocron).

validé 2026-05-21 11-tatooine-rebuild.md
12 draft

Vision — Dashboard deploy

Déployer le dashboard Vision (Astro) sur tatooine via Docker. UI source-of-truth des fiches DR + état infra.

non validé 12-vision-deploy.md
13 draft

minfra-v2 — DR Bootstrap Full

Reconstruction complète de minfra-v2 from scratch (proxmox + templates + VMs + opnsense + docker + vision) en 1 commande. Idempotent : ~60 min from-scratch, ~5 min en re-run.

non validé 09-minfra-dr-bootstrap.md
14 draft

GitLab CE — Setup kamino

Déployer GitLab CE + Runners sur kamino (10.0.2.11). Source-of-truth Git + CI/CD homelab.

non validé 14-gitlab-setup.md
15 draft

VPN WireGuard — Add/Remove peers

Gestion peers WireGuard mobile (téléphone, laptop nomade) : add-peer + QR code, delete-peer. Persistance SOPS + survie DR.

non validé 15-vpn-wireguard.md
16 draft

Expose service public — Traefik endor

Exposer un service interne via Traefik endor en public *.sta4ck.eu (avec Authentik forward-auth optionnel).

non validé 16-expose-traefik.md

Accès rapide