gitea-config/README.md

Gitea - Git with a cup of tea

Instance Gitea auto-hébergée, robuste et performante, utilisant PostgreSQL.

Architecture

• Gitea : Image Rootless (gitea/gitea:1.21-rootless)
• Base de données : PostgreSQL 16 (Alpine)
• Réseaux :
  • proxy_network : Accès via Nginx Proxy Manager.
  • gitea_internal : Communication privée entre Gitea et PostgreSQL.

Configuration

• URL Web : http://localhost:3001 (ou via ton domaine configuré dans NPM)
• SSH : Port 2222
• Utilisateur Système : nb (UID 1001)

Persistence

Les données sont stockées localement sur le SSD pour des performances optimales :

• ./data : Données applicatives et dépôts Git.
• ./config : Configuration Gitea (app.ini).
• ./db_data : Fichiers de la base de données PostgreSQL.

Sauvegardes (Backups)

Un script de sauvegarde automatisé est en place :

• Script : ./backup_gitea.sh
• Destination : /mnt/nas_freebox/backup/gitea/
• Fréquence : Quotidienne à 03h00 via Cron.
• Rétention : 7 jours sur le NAS.

Commandes utiles

# Lancer les services
docker compose up -d

# Arrêter les services
docker compose down

# Voir les logs
docker compose logs -f

# Lancer un backup manuel
./backup_gitea.sh

Dépannage (Troubleshooting)

Erreur réseau NPM (16/05/2026)

• Problème : Impossible d'accéder à Gitea via l'URL locale ou le domaine. NPM était arrêté avec l'erreur network not found.
• Cause : Désynchronisation de l'ID du réseau proxy_network après des modifications d'infrastructure.
• Résolution : Redémarrage complet de NPM via docker compose down && docker compose up -d pour forcer la reconnexion au réseau externe.