diff --git a/README.md b/README.md index 696c69d..d0cc70a 100644 --- a/README.md +++ b/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 \ No newline at end of file +## 🏗️ 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.