Installer Gitea : votre propre GitHub

Gitea héberge vos dépôts Git avec une interface proche de GitHub : tickets, pull requests, wiki, et même l’intégration continue. Il est léger (200 Mo de RAM) et rapide.

Installer

Dans Mon serveur, ajoutez Gitea. Adresse proposée : git.mondomaine.fr.

Tout de suite après l’installation, ouvrez l’adresse : la page d’installation s’affiche. Tant qu’elle n’est pas validée, le premier visiteur peut configurer l’instance à votre place et en devenir l’administrateur.

La page d’installation

Presque tout est déjà réglé par le compose.yml (domaine, adresse, port SSH). Il reste :

Base de données : gardez SQLite. C’est largement suffisant pour un usage personnel ou familial, et c’est un simple fichier, facile à sauvegarder.
Tout en bas, Paramètres de compte administrateur : créez votre compte. Ne sautez pas cette étape.
Cliquez sur Installer Gitea.

Les inscriptions sont désactivées (DISABLE_REGISTRATION) : personne d’autre ne peut créer de compte. Pour inviter quelqu’un, créez-lui un compte depuis Administration du site → Comptes.

Pousser un premier dépôt

Créez un dépôt vide dans Gitea (bouton + → Nouveau dépôt), puis depuis votre ordinateur :

cd mon-projet
git remote add gitea https://git.mondomaine.fr/vous/mon-projet.git
git push -u gitea main

En HTTPS, Git demande votre identifiant et un mot de passe : utilisez plutôt un jeton d’accès (Paramètres → Applications → Générer un jeton), plus sûr que votre vrai mot de passe.

Utiliser SSH (port 2222)

Le port 22 est déjà pris par le SSH du serveur : Gitea écoute donc sur le 2222.

Ouvrez le port dans le pare-feu, s’il ne l’est pas : sudo ufw allow 2222/tcp.
Ajoutez votre clé publique dans Gitea : Paramètres → Clés SSH / GPG.
Les adresses SSH ressemblent alors à :

git remote add gitea ssh://git@git.mondomaine.fr:2222/vous/mon-projet.git

Pour ne pas retaper le port, ajoutez dans ~/.ssh/config sur votre ordinateur :

Host git.mondomaine.fr
    Port 2222
    User git

Faire un miroir de ses dépôts GitHub

+ → Nouvelle migration → GitHub : indiquez l’adresse du dépôt et cochez Ce dépôt sera un miroir. Gitea le synchronise ensuite régulièrement. Vous gardez une copie de tout votre code chez vous, même si votre compte GitHub disparaît.

Mises à jour

L’image est gitea/gitea:1 : la mise à jour automatique installe les versions 1.x, qui restent compatibles. Le passage à une version 2 éventuelle se fera à la main, en lisant les notes de version.

Sauvegarde

Tout (dépôts, base SQLite, configuration) est dans /opt/stacks/gitea/data, inclus dans la sauvegarde de la nuit. Gitea propose aussi sa propre commande d’export complet, gitea dump, utile pour changer de serveur.

Une commande qui ne marche pas, une explication pas claire ? Signaler une erreur dans cette page.