Added: Algemene readme

README.md

@@ -1,3 +1,33 @@
-# Servers
+# 🚀 Servers - Van Emous Mantelzorgwoningen
+Deze repository bevat de Docker-architectuur voor de diensten op onze VPS. De stack is modulair opgezet en maakt gebruik van een gedeeld netwerk voor veiligheid en overzicht.
 
-Alle installatiebestanden van de servers
+## 🏗️ Caddy Gateway
+Het belangrijkste onderdeel is de **Caddy Reverse Proxy**.
+
+> **LET OP:** Caddy moet draaien voordat de andere diensten (Gitea, Plausible, Vaultwarden, etc) correct kunnen functioneren. Caddy beheert namelijk het externe netwerk en de SSL-certificaten.
+
+### Netwerk-architectuur
+De stack maakt gebruik van een extern Docker-netwerk genaamd `caddy_ntwk`.
+
+* **Modulaire setup:** Elke dienst heeft zijn eigen `docker-compose.yml`. Dit houdt de configuratie schoon.
+* **Gedeeld netwerk:** Alle diensten zijn gekoppeld aan `caddy_ntwk` zodat ze onderling bereikbaar zijn via hun containernaam (bijv. `http://gitea:3000`).
+
+## 🛠️ Gebruik op een nieuwe VPS
+
+### 1. Initialiseer het netwerk
+Maak handmatig het netwerk aan voordat je de containers start:
+
+```bash
+docker network create caddy_ntwk
+
+```
+
+### 2. Startvolgorde
+1. Start eerst de **Caddy** stack.
+2. Start daarna de overige stacks naar keuze (**Gitea**, **Plausible**, **Vaultwarden**).
+
+### 3. Standalone gebruik
+Wil je een dienst draaien zonder Caddy of op een server waar deze de enige dienst is? Dan moet je in de `docker-compose.yml` van die dienst:
+
+1. De poorten mappen naar de host (bijv. `- "80:80"`).
+2. De `networks:` sectie aanpassen van `external: true` naar een lokale driver, of de poort-mapping gebruiken om direct toegang te krijgen.