collectivit/docker-forgejo
collectivit/docker-forgejo
2
0
Fork 0
generated from collectivit/docker-template
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Conteneurisation de la forge git Forgejo (https://forgejo.org/)
6 commits 1 branch 0 tags 45 KiB
  • Go Template 42.9%
  • Shell 33.3%
  • Dockerfile 23.8%
Find a file
Exact
Marie e69605846d feat: migrate from collectivit.fr to collectivit.org 
refers to #82
2026-08-18 03:27:17 +02:00
config feat: configure Forgejo container 2026-06-28 09:51:13 +02:00
scripts feat: configure Forgejo container 2026-06-28 09:51:13 +02:00
.pre-commit-config.yaml chore: initial commit 2026-06-28 00:26:47 +02:00
docker-compose.yaml feat: migrate from collectivit.fr to collectivit.org 2026-08-18 03:27:17 +02:00
Dockerfile chore: update author in container metadata 2026-06-28 18:50:13 +02:00
LICENSE chore: initial commit 2026-06-28 00:26:47 +02:00
README.md feat: add docker-compose configuration for local testing 2026-06-28 10:08:06 +02:00

README.md

docker-forgejo

Aperçu

Ce container Docker fait tourner la forge git Forgejo (https://forgejo.org/).

Variables d'environnement

Les variables d'environnement suivantes doivent être définies :

Général

  • HOSTNAME : Nom d'hôte utilisé pour accéder à Forgejo.

  • ROOT_URL : Url racine de cette instance de Forgejo.

Base de données

Forgejo utilise une base PostgreSQL, la connection se fait en clair, sans SSL. Les variables suivantes permettent de configurer la connection à la base de données :

  • DB_HOST (requis) : Nom d'hôte de la base PostgreSQL.
  • DB_NAME (requis) : Nom de la base de données pour Forgejo.
  • DB_USER (requis) : Utilisateur pour se connecter à la base de données.
  • DB_PASSWORD (requis) : Mot de passe pour se connecter à la base de données.

OIDC

Forgejo est automatiquement configuré au démarrage pour utiliser un fournisseur d'identité OIDC pour l'authentification des utilisateurices. Les valeurs suivantes permettent de configurer l'intégration OIDC :

  • OIDC_PROVIDER_NAME (oidc par défaut) : Identifiant du fournisseur d'identité OpenID à configurer automatiquement. Il peut s'agir d'une valeur arbitraire, elle sert uniquement à nommer le provider OpenID dans Forgejo.

  • OIDC_CLIENT_ID (requis) : Identifiant client associé à Forgejo, configuré au niveau du fournisseur d'identité OpenID.

  • OIDC_CLIENT_SECRET (requis) : Secret du client associé à Forgejo, configuré au niveau du fournisseur d'identité OpenID.

  • OIDC_AUTO_DISCOVER_URL (requis) : Url de configuration automatique exposée par le fournisseur d'identité OpenID (généralement, une url se terminant en .well-known/openid-configuration).

Stockage Objet

Forgejo est configuré pour utiliser du stockage objet (S3) pour différentes données (Avatars, LFS..). Les paramètres suivants permettent de configurer ce stockage objet :

  • S3_USE_SSL (true par défaut) : Utiliser HTTPS lors des requêtes au stockage objet.

  • S3_ENDPOINT (requis) : L'url de l'API de stockage objet.

  • S3_ACCESS_KEY_ID (requis) : L'identifiant de la clé d'accẻs au stockage objet.

  • S3_ACCESS_KEY_SECRET (requis) : Le secret associé à la clé d'accès au stockage objet.

  • S3_BUCKET (requis) : Le container de stockage objet à utiliser.

  • S3_REGION (us-east1 par défaut) : La région où du container de stockage objet.

SMTP

L'envoi de mails par Forgejo peut être configuré de la manière suivante :

  • SMTP_SERVER (requis) : L'adresse du serveur SMTP à utiliser pour envoyer des mails.

  • SMTP_PORT (25 par défaut) : Le port du serveur SMTP à utiliser pour envoyer des mails.

  • MAIL_FROM (requis) : La valeur à spécifier dans le champs "From" des mails envoyés par Forgejo.

Développement

Le fichier docker-compose permet de lancer Forgejo sur une machine locale. Une base de donnée PostgreSQL est automatiquement crée, ainsi qu'une instance de Minio pour implémenter le stockage objet. Pour démarrer Forgejo sur votre machine, installez docker et docker compose, et lancez :

docker-compose up --build

L'instance de bookstack sera disponible à http://localhost:9420. Une instance de mailtacher sera également accessible à l'addresse http://localhost:9421 pour consulter les mails envoyés par Forgejo.