Documentation : Mise en place de Gitea sur Debian 12 (LXC)Cette documentation détaille l'installation, la configuration et la sécurisation d'une instance Gitea. Gitea est une solution de forge Git légère, écrite en Go, parfaite pour une exécution optimisée en conteneur LXC.1. Schéma de l'Architecture2. PrérequisHôte : Proxmox VE avec un conteneur LXC Debian 12 (Bookworm).Ressources minimales : 1 vCPU, 512 Mo RAM, 10 Go disque (ajuster selon les dépôts).Privilèges : Accès root sur le conteneur.Réseau : Une adresse IP statique configurée.3. Installation du SystèmeMise à jour et dépendancesMettre à jour les dépôts et installer les outils nécessaires :apt update && apt upgrade -y apt install -y git sqlite3 curl gnupg2 Création de l'utilisateur dédiéCréer un utilisateur système git pour isoler l'exécution du service :adduser --system --shell /bin/bash --gecos 'Git Version Control'
--group --disabled-password --home /home/git git 4. Déploiement du BinaireArborescence de fichiersRespecter la hiérarchie standard pour faciliter les sauvegardes :/usr/local/bin/gitea : Le binaire./var/lib/gitea : Données, dépôts et logs./etc/gitea : Fichiers de configuration.# Création des dossiers mkdir -p /var/lib/gitea/{custom,data,log,indexers,queues} chown -R git:git /var/lib/gitea/ chmod -R 750 /var/lib/gitea/

mkdir -p /etc/gitea chown root:git /etc/gitea chmod 770 /etc/gitea TéléchargementRécupérer la dernière version stable (exemple ici : 1.21.4) :GITEA_VER="1.21.4" curl -L "[https://dl.gitea.com/gitea/](https://dl.gitea.com/gitea/){GITEA_VER}/gitea-${GITEA_VER}-linux-amd64" -o /usr/local/bin/gitea chmod +x /usr/local/bin/gitea 5. Persistance et Service SystemdCréer le fichier /etc/systemd/system/gitea.service pour gérer le cycle de vie du processus :[Unit] Description=Gitea (Git with a cup of tea) After=network.target

[Service] RestartSec=2s Type=simple User=git Group=git WorkingDirectory=/var/lib/gitea/ ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini Restart=always Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea

[Install] WantedBy=multi-user.target Activer le service au démarrage :systemctl daemon-reload systemctl enable --now gitea 6. Configuration Initiale (Interface Web)Se rendre sur http://<IP_DU_LXC>:3000.ParamètreValeur recommandéeType de base de donnéesSQLite3Chemin de la base/var/lib/gitea/data/gitea.dbTitre du siteVotre Forge GitChemin racine des dépôts/home/git/gitea-repositoriesUtilisateur systèmegitURL de basehttp://<IP_OU_DOMAINE>:3000/Note : Créer le compte administrateur immédiatement via la section "Paramètres du compte administrateur" en bas de page pour éviter que le premier visiteur ne devienne admin.7. Sécurisation Post-InstallationUne fois l'assistant web terminé, le fichier /etc/gitea/app.ini est généré. Il contient des informations sensibles.Verrouillage des permissionschmod 440 /etc/gitea/app.ini chown root:git /etc/gitea/app.ini Optimisations dans app.iniModifier les sections suivantes pour renforcer la sécurité :[security] INSTALL_LOCK = true ; Empêche de relancer l'assistant DISABLE_GIT_HOOKS = true ; Sécurité contre l'exécution de scripts malveillants via Git

[service] DISABLE_REGISTRATION = true ; Désactiver l'auto-inscription si usage privé SHOW_REGISTRATION_BUTTON = false 8. Maintenance et Mise à jourPour mettre à jour Gitea, le processus est extrêmement simple :Stopper le service : systemctl stop gitea.Télécharger le nouveau binaire et écraser l'ancien dans /usr/local/bin/gitea.Rétablir les permissions : chmod +x /usr/local/bin/gitea.Relancer : systemctl start gitea.9. Stratégie de Sauvegarde (Automatisation)En tant qu'administrateur, privilégier une sauvegarde à froid (snapshot LXC via Proxmox) ou un dump via l'outil interne :# Commande de dump à scripter en cron su - git -c "/usr/local/bin/gitea dump -c /etc/gitea/app.ini"