confluent/GITEA_INSTALLATION.md

Installation Gitea - Résumé

Date: 2025-12-04 Version: Gitea 1.22.6 IP VPS: 57.131.33.10

---

✅ Installation Complétée

Composants installés :

• ✅ PostgreSQL 17
• ✅ Gitea 1.22.6
• ✅ Nginx (reverse proxy)
• ✅ Certbot (Let's Encrypt)

---

📊 Configuration

Base de données PostgreSQL

• Database: giteadb
• User: gitea
• Password: gitea_secure_password_2025

Gitea

• User système: git
• Port interne: 8080
• Dossier data: /var/lib/gitea/
• Config: /etc/gitea/app.ini
• Repos: /home/git/gitea-repositories/

Nginx

• Config: /etc/nginx/sites-available/gitea
• Port: 80 (HTTP) → sera 443 (HTTPS après SSL)
• Domaine: git.alexistrouve.pro

---

🔧 Prochaines étapes (MANUELLES)

1. Configuration DNS ⚠️ ACTION REQUISE

Créer un enregistrement DNS A pointant vers le VPS :

Type: A
Nom: git
Domaine: alexistrouve.pro
Valeur: 57.131.33.10
TTL: 3600 (ou auto)

Résultat: git.alexistrouve.pro → 57.131.33.10

Comment vérifier:

dig git.alexistrouve.pro
# ou
nslookup git.alexistrouve.pro

---

2. Générer le certificat SSL (après DNS)

Une fois le DNS configuré et propagé (5-30 minutes) :

sudo certbot --nginx -d git.alexistrouve.pro

Certbot va :

• Vérifier que le domaine pointe bien vers ce serveur
• Générer un certificat Let's Encrypt
• Modifier automatiquement la config nginx
• Activer HTTPS sur le port 443

---

3. Finaliser l'installation Gitea

Accéder à l'interface web :

Sans SSL (temporaire):

http://57.131.33.10:8080

Avec DNS + SSL (recommandé):

https://git.alexistrouve.pro

Configuration initiale via l'interface :

1. Database Settings (pré-rempli dans app.ini) :

   • Type: PostgreSQL
   • Host: 127.0.0.1:5432
   • Database: giteadb
   • Username: gitea
   • Password: gitea_secure_password_2025

2. General Settings :

   • Site Title: Git Confluent (ou votre choix)
   • Repository Root Path: /home/git/gitea-repositories
   • Git LFS Root Path: /var/lib/gitea/data/lfs
   • Run As Username: git

3. Server and Third-Party Settings :

   • SSH Server Domain: git.alexistrouve.pro
   • SSH Port: 22
   • Gitea HTTP Listen Port: 8080
   • Gitea Base URL: https://git.alexistrouve.pro/
   • Log Path: /var/lib/gitea/log

4. Administrator Account :

   • Créer un compte admin
   • Username: admin (ou votre choix)
   • Email: alexistrouve.pro@gmail.com
   • Password: (choisir un mot de passe fort)

5. Cliquer sur Install Gitea

---

🔄 Commandes utiles

Gérer Gitea

# Status
sudo systemctl status gitea

# Démarrer
sudo systemctl start gitea

# Arrêter
sudo systemctl stop gitea

# Redémarrer
sudo systemctl restart gitea

# Logs
sudo journalctl -u gitea -f

Gérer Nginx

# Tester config
sudo nginx -t

# Recharger
sudo systemctl reload nginx

# Redémarrer
sudo systemctl restart nginx

Gérer PostgreSQL

# Se connecter
sudo -u postgres psql

# Lister bases
sudo -u postgres psql -c "\l"

# Accéder à la base Gitea
sudo -u postgres psql giteadb

Certificat SSL

# Renouveler manuellement
sudo certbot renew

# Tester le renouvellement (dry-run)
sudo certbot renew --dry-run

# Lister certificats
sudo certbot certificates

---

📁 Fichiers importants

/etc/gitea/app.ini                  # Configuration Gitea
/var/lib/gitea/                     # Données Gitea
/home/git/gitea-repositories/       # Repos Git
/etc/nginx/sites-available/gitea    # Config nginx
/etc/systemd/system/gitea.service   # Service systemd

---

🔐 Sécurité

Changer le mot de passe PostgreSQL

sudo -u postgres psql
ALTER USER gitea WITH PASSWORD 'nouveau_mot_de_passe_fort';
\q

Puis mettre à jour /etc/gitea/app.ini :

[database]
PASSWD = nouveau_mot_de_passe_fort

Redémarrer Gitea :

sudo systemctl restart gitea

Firewall (si ufw activé)

sudo ufw allow 80/tcp    # HTTP
sudo ufw allow 443/tcp   # HTTPS
sudo ufw allow 22/tcp    # SSH (déjà ouvert normalement)
sudo ufw reload

---

🚀 Migration depuis Bitbucket

Une fois Gitea configuré, pour migrer un repo :

1. Dans Gitea : + → New Migration → Bitbucket
2. Ou en CLI :

cd /home/git/gitea-repositories/votre-user/
git clone --mirror https://bitbucket.org/AlexisTrouve/confluent.git
cd confluent.git
git push --mirror git@git.alexistrouve.pro:votre-user/confluent.git

---

📞 Support

• Documentation Gitea : https://docs.gitea.com
• Let's Encrypt : https://letsencrypt.org/docs/

---

Installation effectuée par Claude Code le 2025-12-04

🤖 Generated with Claude Code