Installer Gitea : Votre GitHub personnel en 15 minutes

Pourquoi héberger son propre Git

GitHub, GitLab, Bitbucket... Ces services sont pratiques, mais vos dépôts reposent sur leurs serveurs. Gitea vous permet d'avoir votre propre plateforme Git chez vous, comme avoir un coffre-fort personnel pour votre code au lieu de le confier à une banque.

Imaginez Gitea comme un GitHub miniature que vous contrôlez entièrement : vos dépôts restent privés, vous fixez les règles, et il fonctionne même sur un petit Raspberry Pi.

Ce qu'il vous faut avant de commencer

1. Un serveur (VPS à 3€/mois ou Raspberry Pi 4 suffisent)
2. Ubuntu 22.04 LTS ou Debian 12 installé
3. Un nom de domaine (facultatif mais recommandé)
4. 15 minutes de votre temps

Étape 1 : Préparer votre serveur

Connectez-vous à votre serveur via SSH. Si vous ne savez pas comment, imaginez que SSH est comme une télécommande sécurisée qui vous permet de commander votre serveur à distance.

## Mettre à jour le système (comme faire les mises à jour Windows)
sudo apt update
sudo apt upgrade -y

Étape 2 : Installer Docker

Docker est un outil qui permet d'installer des applications dans des "boîtes isolées". Cela simplifie énormément l'installation de Gitea.

## Télécharger et installer Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

## Ajouter votre utilisateur au groupe Docker (pour éviter de taper sudo à chaque commande)
sudo usermod -aG docker $USER

Déconnectez-vous puis reconnectez-vous pour que les changements prennent effet.

Étape 3 : Créer les dossiers de Gitea

Gitea a besoin de deux emplacements pour stocker ses données :

• Les fichiers du programme
• La base de données (où sont stockées les informations utilisateurs, issues, etc.)

## Créer les dossiers
sudo mkdir -p /opt/gitea/data
sudo mkdir -p /opt/gitea/config

## Donner les permissions à votre utilisateur
sudo chown -R $USER:$USER /opt/gitea

Étape 4 : Lancer Gitea avec Docker

C'est l'étape magique. Une seule commande suffit pour démarrer Gitea :

docker run -d \
  —name=gitea \
  -p 3000:3000 \
  -p 2222:22 \
  -v /opt/gitea/data:/data \
  -v /opt/gitea/config:/config \
  -e USER_UID=1000 \
  -e USER_GID=1000 \
  —restart=always \
  gitea/gitea:1.22

Explication simple : cette commande dit à Docker de télécharger Gitea (version 1.22, la dernière stable), de l'installer, et de le configurer pour démarrer automatiquement à chaque redémarrage du serveur.

Le port 3000 est pour l'interface web, et le port 2222 est pour les connexions SSH (nécessaires pour "git push").

Étape 5 : Premier accès et configuration

Attendez environ 30 secondes que Gitea démarre, puis ouvrez votre navigateur à l'adresse :

http://adresse-de-votre-serveur:3000

Vous arrivez sur l'écran d'installation. Voici les réglages importants :

Type de base de données : SQLite3 (parfait pour débuter, aucune configuration requise)

Chemin des dépôts : /data/git/repositories (laissez tel quel)

URL de Gitea : http://votre-ip:3000

Domaine SSH : votre-ip (ou votre nom de domaine si vous en avez un)

Port SSH : 2222 (important ! C'est le port qu'on a configuré plus haut)

Créez votre compte administrateur en bas de page. Ce sera le propriétaire de votre instance Gitea.

Étape 6 : Configurer un nom de domaine (optionnel mais recommandé)

Au lieu de mémoriser une adresse IP, vous pouvez utiliser git.mondomaine.fr. Dans votre registrar (OVH, Gandi, etc.), créez un enregistrement A :

Type : A
Nom : git
Valeur : IP-de-votre-serveur

Attendez quelques minutes que la propagation DNS se fasse, puis accédez à http://git.mondomaine.fr:3000

Étape 7 : Sécuriser avec HTTPS (obligatoire)

Naviguer en HTTP simple, c'est comme envoyer des cartes postales lisibles par tout le monde. HTTPS chiffre vos échanges.

Si vous avez suivi le tutoriel Nginx reverse proxy, ajoutez cette configuration :

server {
    listen 80;
    server_name git.votredomaine.fr;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name git.votredomaine.fr;

    ssl_certificate /etc/letsencrypt/live/votredomaine.fr/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/votredomaine.fr/privkey.pem;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Puis obtenez votre certificat SSL :

sudo certbot —nginx -d git.votredomaine.fr

Étape 8 : Créer votre premier dépôt

1. Connectez-vous à Gitea
2. Cliquez sur le "+" en haut à droite
3. Choisissez "Nouveau dépôt"
4. Donnez-lui un nom (ex: "mon-projet")
5. Cochez "Initialiser ce dépôt avec un README"
6. Cliquez sur "Créer un dépôt"

Étape 9 : Cloner et utiliser votre dépôt

Sur votre ordinateur local :

## Cloner le dépôt
git clone ssh://git@votredomaine.fr:2222/votre-utilisateur/mon-projet.git

## Ou en HTTPS
git clone https://git.votredomaine.fr/votre-utilisateur/mon-projet.git

## Entrer dans le dossier
cd mon-projet

## Créer un fichier
echo "# Mon projet" > README.md

## Envoyer sur votre serveur
git add .
git commit -m "Premier commit"
git push origin main

Conclusion

Vous disposez maintenant de votre propre GitHub personnel. Gitea offre 90% des fonctionnalités de GitHub (issues, pull requests, wiki, actions CI) tout en restant léger et entièrement sous votre contrôle. Vos dépôts privés le restent vraiment, et vous pouvez créer autant d'utilisateurs et de projets que vous le souhaitez.

Pour aller plus loin, explorez les paramètres d'administration où vous pourrez activer l'intégration continue, configurer des webhooks, ou lier Gitea à des services externes.