Héberger ses dépôts Git avec Gitea sur Raspberry Pi
Pour un développeur, héberger ses propres dépôts Git offre confidentialité et indépendance. Gitea est une forge logicielle légère, qui reproduit l’essentiel de l’expérience GitHub sur un simple Raspberry Pi. Idéale pour vos projets personnels ou d’équipe, voici comment la déployer.
Gitea, GitHub à la maison
Gitea propose dépôts Git, suivi des tickets, demandes de fusion, wiki et bien plus, dans une interface familière. Écrite en Go, elle est remarquablement légère et tourne sans peine sur un Pi. Son code est, logiquement, hébergé sur GitHub. C’est un excellent ajout à un homelab de développeur, dans l’esprit de nos autres tutoriels d’auto-hébergement.
Le matériel
- Un Raspberry Pi 5 ou Pi 4
- Un SSD recommandé pour la rapidité et la fiabilité
Étape 1 : déployer Gitea avec Docker
La méthode la plus propre passe par Docker (voir notre guide Docker). Lancez Gitea en montant un volume de données et en exposant les ports web et SSH :
docker run -d --name gitea \
-v gitea-data:/data \
-p 3000:3000 -p 222:22 \
gitea/gitea:latest
Étape 2 : configuration initiale
Accédez à l’interface sur le port 3000. L’assistant vous guide pour choisir la base de données (SQLite suffit pour un usage personnel), définir l’URL et créer le compte administrateur. En quelques minutes, votre forge est opérationnelle.
Étape 3 : créer et utiliser un dépôt
Créez votre premier dépôt depuis l’interface, puis clonez-le sur votre machine de développement. Vous travaillez ensuite exactement comme avec GitHub : commits, branches, push, pull. Configurez vos clés SSH pour des opérations fluides et sécurisées.
git clone git@VOTRE_PI:222/utilisateur/projet.git
Étape 4 : aller plus loin
Gitea permet bien plus : gestion d’organisations et d’équipes, intégration continue avec Gitea Actions, miroirs de dépôts, et webhooks. Pour une petite équipe, c’est une plateforme complète. Vous pouvez même y miroiter vos projets publics GitHub pour en garder une copie locale.
Sécurité et sauvegarde
Vos dépôts représentent un travail précieux : sauvegardez régulièrement le volume de données (voir notre tutoriel Restic). Pour l’accès depuis l’extérieur, préférez un VPN WireGuard à une exposition directe sur Internet.
Conclusion
Gitea sur Raspberry Pi met une forge logicielle complète et privée à votre disposition, sans dépendre d’un service tiers. Légère, complète et familière, c’est la solution idéale pour héberger ses projets de code en toute indépendance. Le compagnon parfait de tout développeur soucieux de sa souveraineté numérique.