From 041b00a28544e9fb10bbaf292cb051191af88a15 Mon Sep 17 00:00:00 2001
From: TheThomaas <thethomaas@protonmail.ch>
Date: Mon, 19 Oct 2026 10:55:03 +0200
Subject: [PATCH] Add README files to server folder

---
 README.md                     |  8 +++++++-
 REAMDE.md.example             | 31 +++++++++++++++++++++++++++++++
 servers/docker/README.md      |  7 +++++++
 servers/sunstreaker/README.md |  3 +++
 4 files changed, 48 insertions(+), 1 deletion(-)
 create mode 100644 REAMDE.md.example
 create mode 100644 servers/docker/README.md
 create mode 100644 servers/sunstreaker/README.md

diff --git a/README.md b/README.md
index 2740dd1..5579d92 100644
--- a/README.md
+++ b/README.md
@@ -13,4 +13,10 @@ cp servers/<serveur>/.env.example servers/<serveur>/.env
 
 # 3. Créer le réseau partagé
 docker network create proxy
-```
\ No newline at end of file
+```
+
+## Serveurs
+
+- [`servers/docker/`](servers/docker/README.md) — docker
+- [`servers/sunstreaker/`](servers/sunstreaker/README.md) — sunstreaker (test)
+- [`servers/nas/`](servers/nas/README.md) — stockage (à venir)
\ No newline at end of file
diff --git a/REAMDE.md.example b/REAMDE.md.example
new file mode 100644
index 0000000..48c3457
--- /dev/null
+++ b/REAMDE.md.example
@@ -0,0 +1,31 @@
+# Serveur principal
+
+Machine de production hébergeant les services du quotidien.
+
+## Caractéristiques
+
+- **IP locale** : `192.168.1.10`
+- **Sous-réseau** : `192.168.1.0/24`
+- **Rôle** : production
+- **Hyperviseur** : Proxmox (VM `docker-node`)
+- **Stockage** : volumes montés depuis le NAS (`nas-storage`) via NFS
+
+## Stacks déployées
+
+| Service | Dossier | URL locale | URL externe | Notes |
+|---|---|---|---|---|
+| Radarr | `radarr/` | `radarr.home.lan` | `radarr.example.com` | Images épinglées |
+| Sonarr | `sonarr/` | `sonarr.home.lan` | `sonarr.example.com` | |
+| Jellyfin | `jellyfin/` | `jellyfin.home.lan` | `jellyfin.example.com` | Lecture seule sur `$MEDIADIR` |
+| Forgejo | `forgejo/` | `forgejo.home.lan` | — | Accès local uniquement |
+
+## Spécificités
+
+- Le réseau `proxy` est partagé avec les autres serveurs.
+- Les médias sont montés en lecture seule pour Jellyfin, en lecture/écriture pour Sonarr/Radarr.
+- Les secrets sont dans `servers/principal/.env` (non versionné).
+
+## Dépendances
+
+- Dépend du NAS (`nas-storage`) pour les partages NFS.
+- Dépend de Pocket-ID pour l'authentification à Komodo.
\ No newline at end of file
diff --git a/servers/docker/README.md b/servers/docker/README.md
new file mode 100644
index 0000000..18d1d12
--- /dev/null
+++ b/servers/docker/README.md
@@ -0,0 +1,7 @@
+# Serveur principal (docker)
+
+Machine de production hébergeant les services du quotidien.
+
+## Dépendances
+
+- Dépend du NAS (Orion) pour les partages NFS.
\ No newline at end of file
diff --git a/servers/sunstreaker/README.md b/servers/sunstreaker/README.md
new file mode 100644
index 0000000..e72470d
--- /dev/null
+++ b/servers/sunstreaker/README.md
@@ -0,0 +1,3 @@
+# Sunstreaker
+
+Machine de test
\ No newline at end of file