FerrisGitInstallation

Installation

FerrisGit se déploie sous la forme d'une image de conteneur, accompagnée de PostgreSQL. Trois modes d'installation : Docker Compose, le chart Helm sur Kubernetes, ou depuis les sources.

Docker Compose

Démarrer la pile avec Docker Compose

git clone https://github.com/Masmarino/FerrisGit.git
cd FerrisGit
cp .env.example .env
# set POSTGRES_PASSWORD, JWT_SECRET, SETTINGS_ENCRYPTION_KEY and the admin password in .env
docker compose up -d --build

Compose construit l'image depuis les sources. Pour utiliser l'image publiée, remplacez build: . par image: masmarino/ferrisgit:0.1.3 dans docker-compose.yml.

Guide d'installation

Chart Helm

Installer le chart sur Kubernetes

git clone https://github.com/Masmarino/FerrisGit.git
cd FerrisGit
helm upgrade --install ferrisgit ./helm/ferrisgit \
  --namespace ferrisgit --create-namespace \
  --set image.tag=0.1.3 \
  --set ingress.host=git.example.com \
  --set-string ferrisgit.trustedProxyCidrs=10.42.0.0/16
kubectl -n ferrisgit rollout status deployment/ferrisgit

Laissées vides, le chart génère le mot de passe de la base, JWT_SECRET, SETTINGS_ENCRYPTION_KEY et le mot de passe du premier administrateur dans le Secret ferrisgit-secrets. La release doit s'appeler ferrisgit.

Déploiement sur Kubernetes

Depuis les sources

Lancer le backend et l'application web en local

git clone https://github.com/Masmarino/FerrisGit.git
cd FerrisGit
cp .env.example .env          # then set real secrets
./scripts/dev.sh              # PostgreSQL via Compose, cargo run on :8080, ng serve on :4201

Il faut rustup, Node.js 26, Docker avec Compose et git dans le PATH. Le script démarre PostgreSQL, applique les migrations et lance le backend sur le port 8080 et le serveur de développement Angular sur le port 4201.

Guide d'installation

Ce qui se passe ensuite

1
Le serveur refuse de démarrer tant qu'un secret manque ou est trop court : JWT_SECRET demande 32 caractères au moins, SETTINGS_ENCRYPTION_KEY exactement 32.
2
Il se connecte à PostgreSQL, applique ses migrations, crée le premier administrateur si la table des utilisateurs est vide, et écoute sur le port 8080.
3
La première connexion vous guide pour enrôler une application d'authentification ou une clé d'accès, et affiche vos dix codes de secours. Il n'y a pas de moyen de passer outre.

Ce qu'il vous faut

Docker avec le plugin Compose, ou un cluster Kubernetes avec Traefik, un CNI qui applique les NetworkPolicy et une StorageClass par défaut.
PostgreSQL 18 : la pile Compose et le chart apportent le leur.
Un nom de domaine et TLS devant, par un reverse proxy : FerrisGit ne termine pas HTTPS lui-même, et les clés d'accès ne fonctionnent que sur une origine sécurisée.

Évaluez FerrisGit, puis déployez votre propre instance.

L'instance publique permet de découvrir le produit. Votre instance conserve votre code.

Ouvrir FerrisGit Guide d'installation