# 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

```bash
# 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.