Git auto-hébergé avec Gitea sur un VPS - installation Docker…

Lancez votre propre serveur Git façon GitHub avec Gitea, PostgreSQL et HTTPS sur un VPS à 12 € : docker compose, reverse proxy Caddy, accès SSH pour git push et sauvegardes.

Gitea est un service Git léger avec tickets, pull requests et hooks CI - tout ce que vous attendez, en quelques centaines de mégaoctets. Sur un VPS à 16 €, il sert toute une équipe.

1. Installez Docker

apt update && apt install -y docker.io docker-compose-v2 git
systemctl enable --now docker

Pas à pas complet, bases de Compose incluses : guide Docker.

2. Le fichier Compose

mkdir -p /opt/gitea && cd /opt/gitea
cat > docker-compose.yml <<'EOF'
services:
  db:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: gitea
      POSTGRES_PASSWORD: change-me-db
      POSTGRES_DB: gitea
    volumes:
      - ./db:/var/lib/postgresql/data
  gitea:
    image: gitea/gitea:1
    restart: unless-stopped
    depends_on: [db]
    environment:
      GITEA__database__DB_TYPE: postgres
      GITEA__database__HOST: db:5432
      GITEA__database__NAME: gitea
      GITEA__database__USER: gitea
      GITEA__database__PASSWD: change-me-db
    volumes:
      - ./data:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "127.0.0.1:3000:3000"
      - "2222:22"
EOF
docker compose up -d

Notez les liaisons : l’interface web n’écoute que sur localhost, tandis que SSH pour `git push` est sur le port 2222. Rendez ce port accessible - soit en ouvrant 2222 dans le pare-feu, soit en servant Git plus tard en HTTPS.

3. HTTPS avec Caddy

apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
git.example.com {
    reverse_proxy 127.0.0.1:3000
}
EOF
systemctl reload caddy

Caddy obtient le certificat automatiquement. Faites d’abord pointer l’enregistrement A du domaine vers le serveur, puis terminez l’assistant d’installation dans le navigateur - le premier compte créé devient l’administrateur.

4. Poussez le code

git remote add origin ssh://[email protected]:2222/you/project.git
git push -u origin main

Ajoutez votre clé publique dans les paramètres de Gitea une seule fois, et chaque push suivant se fait sans mot de passe.

5. Des sauvegardes qui se restaurent vraiment

docker compose exec -u git gitea gitea dump -c /data/gitea/conf/app.ini
# the dump lands in /opt/gitea/data/gitea, then ship it off-site:
restic backup /opt/gitea/data --exclude-caches

La commande `gitea dump` regroupe la base de données, les dépôts et la configuration dans une seule archive. Pour les copies hors site, voir le guide restic.

Réponses rapides

De combien de RAM Gitea a-t-il besoin ?

Le conteneur consomme environ 150 à 250 Mo au repos, PostgreSQL encore 100 à 200 Mo. Un serveur de 2 Go est confortable pour une petite équipe ; 4 Go si vous faites aussi tourner des runners CI ou de nombreux gros dépôts.

Puis-je importer des dépôts depuis GitHub ?

Oui. Dans Gitea, choisissez Nouvelle migration, collez l’URL du dépôt, et il copie le code, les tickets et les pull requests. Les dépôts privés nécessitent un jeton d’accès GitHub.

Mon code est-il en sécurité sur un VPS ?

Il est aussi sûr que votre administration du serveur : clés SSH, pare-feu, mises à jour et sauvegardes hors site couvrent les risques réalistes. Pour beaucoup d’équipes, c’est plus de contrôle que de tout confier à un tiers.

Gitea et PostgreSQL tiennent largement sur un Core VPS 6 (16 €/mois).

À lire aussi

Voir les offresGuidesFAQ