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.

El material

Étape 1 : déployer Gitea avec Docker

La méthode la plus propre passe par Docker (voir notre guía de 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.

Conclusión

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.