Qu'est-ce que Forgejo ?
Forgejo est une forge logicielle légère auto-hébergée. Facile à installer et peu contraignante en maintenance, elle fait simplement le travail. Forgejo est un fork de Gitea piloté par la communauté, axé sur la sécurité, la confidentialité et une gouvernance démocratique — offrant une alternative auto-hébergée à GitHub ou GitLab que vous contrôlez entièrement.
⚡ Fonctionnalités clés de Forgejo
📦 Hébergement de dépôts Git
Hébergez un nombre illimité de dépôts git publics et privés. Prise en charge complète de Git LFS, du stockage de grands fichiers et de la mise en miroir depuis GitHub, GitLab et bien d'autres.
🔄 Pull Requests & Revue de code
Flux de pull requests intégré avec revue de code en ligne, affectation de relecteurs, relecteurs obligatoires et stratégies de fusion incluant squash et rebase.
🐛 Suivi de tickets
Gestionnaire de tickets complet avec étiquettes, jalons, tableau de projets, champs personnalisés et références croisées entre dépôts.
⚙️ Forgejo Actions
Moteur CI/CD intégré compatible avec les workflows GitHub Actions. Utilisez les actions existantes du marketplace GitHub Actions sur votre runner auto-hébergé.
📚 Registre de paquets
Hébergez vos propres paquets : npm, PyPI, Maven, images Docker/OCI, paquets Debian/RPM, charts Helm et bien plus — tout en un seul endroit.
🔐 Sécurité & Contrôle d'accès
Permissions granulaires, authentification à deux facteurs, fournisseur OAuth2, intégration LDAP/SAML, accès SSH et HTTPS, règles de protection des branches.
🏆 Pourquoi choisir Forgejo ?
- Auto-hébergé : Vos données restent sur vos serveurs, sous votre contrôle
- Léger : Fonctionne sur un Raspberry Pi ou un VPS à 5 $/mois
- Compatible Gitea : Remplacement direct avec compatibilité API complète
- Piloté par la communauté : Gouvernance démocratique, sans dépendance à une entreprise
- Compatible GitHub Actions : Réutilisez les workflows existants et les actions du marketplace
apt upgrade vous garde toujours à la dernière version.
📦 Installation depuis deb.griffo.io
Étape 1 : Ajouter le dépôt
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Il existe un miroir gratuit pour toujours. deb-free.griffo.io distribue des paquets gratuitement pour toujours — sans compte, sans abonnement, au plus 2 mois derrière l'upstream, correctifs de sécurité immédiats. Il contient aujourd'hui cliamp, Ghostty, lazydocker, Oh My Posh et Zed ; Forgejo n'en fait pas partie, le dépôt ci-dessus reste donc le seul moyen de l'installer — demandez-le et il pourra y être ajouté.
🧩 À propos de l'option extrepo. extrepo est l'outil de Debian pour les dépôts externes : il écrit le fichier de sources et installe la clé de signature à votre place, après l'avoir vérifiée face à des métadonnées signées. Ce dépôt y est enregistré sous le nom griffo, et le miroir gratuit à vie sous griffo-free ; sur Debian (bookworm, trixie, forky et sid), les commandes ci-dessus constituent donc toute l'installation.
extrepo ne met en place que le fichier de sources et la clé : les identifiants d'un abonnement vont toujours dans /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu n'est pas couvert, car extrepo ne publie de métadonnées que pour les suites Debian : utilisez-y les commandes avec sudo ou en root.
Étape 2 : Installer Forgejo
# Install latest Forgejo (also installs git and git-lfs)
sudo apt install forgejo
# Verify installation
forgejo --version# Install latest Forgejo (also installs git and git-lfs)
apt install forgejo
# Verify installation
forgejo --version🚀 Configuration initiale
Le paquet crée automatiquement l'utilisateur système git, le répertoire de données /var/lib/forgejo et le répertoire de configuration /etc/forgejo. Terminez la configuration avec :
# Start the Forgejo service
sudo systemctl start forgejo
# Open http://localhost:3000 in your browser to complete initial configuration
# (configure database, admin account, domain, etc.)
# After the web setup is complete, enable Forgejo on boot:
sudo systemctl enable forgejo
# Check service status
sudo systemctl status forgejo# Start the Forgejo service
systemctl start forgejo
# Open http://localhost:3000 in your browser to complete initial configuration
# (configure database, admin account, domain, etc.)
# After the web setup is complete, enable Forgejo on boot:
systemctl enable forgejo
# Check service status
systemctl status forgejo🛡️ Durcissement de la sécurité après configuration
Une fois la configuration web terminée, rendez le fichier de configuration en lecture seule pour plus de sécurité :
# Lock down the config directory and app.ini after initial configuration
sudo systemctl stop forgejo
sudo chmod 750 /etc/forgejo
sudo chmod 640 /etc/forgejo/app.ini
sudo systemctl start forgejo# Lock down the config directory and app.ini after initial configuration
systemctl stop forgejo
chmod 750 /etc/forgejo
chmod 640 /etc/forgejo/app.ini
systemctl start forgejo🔧 Administration en ligne de commande
Forgejo fournit une interface CLI pour les tâches d'administration. Exécutez les commandes en tant qu'utilisateur git :
# List all users
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user list
# Create admin user
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user create \
--username admin --password changeme --email admin@example.com --admin
# Regenerate Git hooks (useful after upgrades)
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin regenerate hooks# List all users
-u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user list
# Create admin user
-u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user create \
--username admin --password changeme --email admin@example.com --admin
# Regenerate Git hooks (useful after upgrades)
-u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin regenerate hooks🚀 Pourquoi choisir deb.griffo.io ?
- Debian officiel : Aucun paquet Forgejo disponible dans les dépôts officiels
- Installation manuelle : Nécessite de télécharger et placer le binaire manuellement
- deb.griffo.io : Dernière version avec un empaquetage correct, script postinst et support de mise à jour via apt
- ✅ Derniers correctifs de sécurité : Obtenez toujours la version la plus récente de Forgejo
- ✅ Configuration automatique : Le script post-installation crée l'utilisateur, les répertoires et le service systemd
- ✅ Dépendances correctes : git et git-lfs installés automatiquement
- ✅ Mises à jour automatiques :
apt upgrademaintient Forgejo à jour - ✅ Multi-architecture : Supporte amd64, armhf (Raspberry Pi) et arm64
- ✅ Multi-distribution : Fonctionne sur Bookworm, Trixie et Sid
📦 Dépôt de construction de paquets
Les paquets Debian sont automatiquement construits et maintenus dans ce dépôt GitHub :
- ⚒️ forgejo-debian - Latest release builds
🔗 Paquets associés
Également disponibles depuis deb.griffo.io :
- lazygit - Interface terminal pour Git (excellent compagnon pour les workflows git)
- lazydocker - Interface terminal pour Docker (utile si vous exécutez Forgejo dans des conteneurs)
- eza - Remplacement moderne de la commande ls
💝 Soutenir ce projet
Si ce dépôt vous fait gagner du temps et des efforts, veuillez envisager de le soutenir !