diff --git a/gitea/README.md b/gitea/README.md
index 2473f04..307055b 100644
--- a/gitea/README.md
+++ b/gitea/README.md
@@ -1,7 +1,38 @@
-# Template Gitea
+# Gitea — Template Arcane
 
-Template Arcane pour déployer un serveur Gitea.
+## Description
+Gitea est un serveur Git léger, rapide et auto-hébergeable.  
+Ce template Arcane permet l’installation simple et reproductible de Gitea via Docker.
 
-## Accès
-- Web : http://HOST_IP:3004
-- SSH : ssh -p 222 git@HOST_IP
+## Fonctionnalités
+- Hébergement Git complet
+- Interface web moderne
+- API complète
+- Gestion SSH intégrée
+- Compatible runners CI/CD externes
+
+---
+
+## Prérequis
+- Docker + Docker Compose
+- Port 3004 (HTTP) libre
+- Port 222 (SSH) libre
+- Un domaine (optionnel mais recommandé)
+
+---
+
+## Installation avec Arcane
+
+1. Ouvrir Arcane.
+2. Ajouter un template externe.
+3. Indiquer l’URL du `registry.json` correspondant.
+4. Installer **Gitea**.
+5. Configurer les variables depuis `.env.example`.
+
+---
+
+## Installation manuelle
+
+```bash
+cp .env.example .env
+docker compose up -d