agenthub/docs/FORGEJO-MANUAL-STEPS.md

Installation Forgejo - Étapes manuelles

Ce que vous devez faire

1. Interface Coolify (Principal)

URL: https://coolify.barodine.net

Créer le service Forgejo

1. Naviguer vers le projet

   • Menu: Projects → Barodine IA
   • Cliquer: "+ New Resource"

2. Type de service

   • Choisir: "Service"
   • Type: "Docker Image"

3. Configuration

Paramètre	Valeur
Name	forgejo
Image	codeberg.org/forgejo/forgejo:9
Port	3000
FQDN	git.barodine.net
Enable HTTPS	✅ Oui

4. Volume (IMPORTANT!)

   • Cliquer "Add Volume"
   • Name: forgejo-data
   • Source: /var/lib/forgejo
   • Destination: /data
   • Type: Named volume

5. Variables d'environnement

Copier toutes ces lignes dans la section "Environment Variables":

USER_UID=1000
USER_GID=1000
FORGEJO__database__DB_TYPE=postgres
FORGEJO__database__HOST=rffv6pfwpdftlhunzoishduj:5432
FORGEJO__database__NAME=postgres
FORGEJO__database__USER=postgres
FORGEJO__database__PASSWD=UpW5nyYcNSy88bQiNppIRdFKrtul2Bu4hXzxitzcB4IHU9sAzGc2mkndvKdA1J42
FORGEJO__server__DOMAIN=git.barodine.net
FORGEJO__server__ROOT_URL=https://git.barodine.net
FORGEJO__server__HTTP_PORT=3000
FORGEJO__server__PROTOCOL=http
FORGEJO__server__START_SSH_SERVER=true
FORGEJO__server__SSH_PORT=2222
FORGEJO__server__SSH_LISTEN_PORT=22
FORGEJO__security__INSTALL_LOCK=false
FORGEJO__security__SECRET_KEY=ChangeThisToARandomSecretKey32Chars1234567890
FORGEJO__service__DISABLE_REGISTRATION=false
FORGEJO__service__REQUIRE_SIGNIN_VIEW=false
FORGEJO__service__ENABLE_NOTIFY_MAIL=false
FORGEJO__session__PROVIDER=memory

6. Déployer
   • Cliquer "Deploy"
   • Attendre 1-2 minutes (voir les logs)

---

2. Terminal de 192.168.9.25 (Optionnel - Vérification uniquement)

Vous n'avez RIEN à faire sur le terminal si Coolify fonctionne correctement.

Mais si vous voulez vérifier que tout est OK:

Vérification 1: Docker est bien démarré

ssh user@192.168.9.25

# Vérifier que Docker tourne
sudo systemctl status docker

# Devrait afficher: active (running)

Vérification 2: Le container Forgejo est bien créé

# Lister les containers Coolify
sudo docker ps | grep forgejo

# Devrait afficher quelque chose comme:
# abc123... codeberg.org/forgejo/forgejo:9 ... Up 2 minutes ... forgejo

Vérification 3: Les logs du container

# Voir les logs Forgejo
sudo docker logs -f $(sudo docker ps | grep forgejo | awk '{print $1}')

# Chercher cette ligne (indique que Forgejo a démarré):
# "Starting new Web server: tcp:0.0.0.0:3000"

# Appuyer sur Ctrl+C pour quitter les logs

Vérification 4: Tester la connexion DB (si problème)

# Se connecter au container Forgejo
sudo docker exec -it $(sudo docker ps | grep forgejo | awk '{print $1}') sh

# Dans le container, tester la connexion PostgreSQL
psql "postgres://postgres:UpW5nyYcNSy88bQiNppIRdFKrtul2Bu4hXzxitzcB4IHU9sAzGc2mkndvKdA1J42@rffv6pfwpdftlhunzoishduj:5432/postgres"

# Si ça se connecte, c'est bon! Taper \q pour quitter
# Taper exit pour sortir du container

Si le port SSH 2222 ne fonctionne pas (optionnel)

Par défaut, Forgejo expose SSH sur le port 2222. Si vous voulez cloner via SSH:

# Ouvrir le port dans le firewall
sudo ufw allow 2222/tcp

# Vérifier que le port est ouvert
sudo ufw status | grep 2222

---

3. Configuration initiale de Forgejo (Navigateur)

Une fois que Forgejo est déployé:

1. Ouvrir: https://git.barodine.net

2. Page d'installation s'affiche automatiquement

3. Paramètres déjà configurés (via les env vars):

   • Type DB: PostgreSQL
   • Host: rffv6pfwpdftlhunzoishduj:5432
   • User: postgres
   • Password: (déjà rempli)
   • Database: postgres

4. Configurer l'admin:

   • Username: admin (ou votre choix)
   • Password: (choisir un mot de passe fort)
   • Email: votre email

5. Paramètres du site:

   • Site Title: Barodine Git
   • Server Domain: git.barodine.net (déjà rempli)
   • SSH Server Port: 2222 (déjà rempli)
   • Base URL: https://git.barodine.net (déjà rempli)

6. Cliquer "Install Forgejo"

7. Connexion:

   • Se connecter avec le compte admin créé

---

4. Créer le premier repository (AgentHub)

1. Dans Forgejo, cliquer "+" → "New Repository"
2. Configurer:
   • Owner: Votre username
   • Repository Name: agenthub
   • Description: "AgentHub - Hub de communication temps réel pour agents IA"
   • Visibility: Private (ou Public selon besoin)
   • Initialize: ❌ NON (on va pousser le code existant)
3. Cliquer "Create Repository"
4. Copier l'URL HTTPS affichée (ex: https://git.barodine.net/admin/agenthub.git)

---

5. Pousser le code AgentHub vers Forgejo (Sur votre machine de dev)

# Se placer dans le répertoire AgentHub
cd /home/alexandre/.paperclip/instances/default/workspaces/8780faf8-03bb-45e9-989e-167eeb438b58/agenthub

# Supprimer le remote GitHub (ou le garder si vous voulez les deux)
git remote remove origin

# Ajouter Forgejo comme remote origin
git remote add origin https://git.barodine.net/admin/agenthub.git

# Pousser le code
git push -u origin main

# Entrer vos credentials Forgejo quand demandé

---

Résumé des actions

Action	Où	Temps
1. Créer service Forgejo	Coolify web (https://coolify.barodine.net)	5 min
2. Vérifier logs	Coolify → Onglet Logs	1 min
3. Configuration initiale Forgejo	Navigateur (https://git.barodine.net)	3 min
4. Créer repo AgentHub	Forgejo web	2 min
5. Pousser le code	Terminal local	2 min

Total: ~13 minutes

---

Troubleshooting rapide

Forgejo ne démarre pas

1. Vérifier les logs dans Coolify → Logs
2. Chercher des erreurs de connexion DB
3. Vérifier que la DB Postgres est bien UP dans Coolify → Databases

Page d'installation ne s'affiche pas

1. Vérifier que FORGEJO__security__INSTALL_LOCK=false
2. Redémarrer le service dans Coolify

SSH ne fonctionne pas

1. Dans Coolify, aller dans Forgejo → Networking
2. Ajouter un port mapping:
   • Host Port: 2222
   • Container Port: 22
3. Redémarrer le service

Cannot push to Forgejo

1. Vérifier que le repo est bien créé dans Forgejo
2. Vérifier que vous utilisez la bonne URL (copier depuis Forgejo)
3. Vérifier vos credentials (username/password)

---

Prochaines étapes après installation

1. ✅ Forgejo installé et accessible
2. ✅ Repository AgentHub créé
3. ✅ Code poussé vers Forgejo
4. ⏳ Créer l'application AgentHub dans Coolify (source: Forgejo)
5. ⏳ Configurer le webhook Forgejo → Coolify
6. ⏳ Déployer AgentHub et tester /metrics