diff --git a/heimdall/README.md b/heimdall/README.md
new file mode 100644
index 0000000..2d06f29
--- /dev/null
+++ b/heimdall/README.md
@@ -0,0 +1,20 @@
+# Heimdall
+
+Stack Docker pour **Heimdall** via l’image linuxserver/heimdall.
+
+### Configuration
+- Ports exposés : 8002 (HTTP), 7843 (HTTPS)
+- Volumes :
+  - `./config:/config` pour la config persistante
+  - `./custom_icons:/config/www/custom_icons` pour icônes personnalisées
+- Variables d’environnement dans `.env.example`
+
+### Utilisation
+1. Déposer ce dossier dans votre dépôt de templates.
+2. Ajuster les valeurs dans `.env.example` si nécessaire.
+3. Lancer via : `docker-compose up -d`
+4. Accéder à Heimdall via `http://<serveur>:8002`
+
+### Notes
+- Configurez HTTPS ou reverse-proxy pour le port 7843 si utilisé.
+- Placez vos icônes personnalisées dans `custom_icons` avant lancement.