FerrisGitInstallation

Installation

FerrisGit wird als Container-Image zusammen mit PostgreSQL betrieben. Es gibt drei Installationswege: Docker Compose, das Helm-Chart auf Kubernetes oder den Quellcode.

Docker Compose

Den Stack mit Docker Compose starten

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 baut das Image aus dem Quellcode. Um stattdessen das veröffentlichte Image zu verwenden, ersetze build: . durch image: masmarino/ferrisgit:0.1.3 in docker-compose.yml.

Installationsanleitung (auf Französisch)

Helm-Chart

Das Chart auf Kubernetes installieren

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

Bleiben sie leer, erzeugt das Chart das Datenbankpasswort, JWT_SECRET, SETTINGS_ENCRYPTION_KEY und das Passwort des ersten Administrators im Secret ferrisgit-secrets. Das Release muss ferrisgit heißen.

Deployment auf Kubernetes (auf Französisch)

Aus dem Quellcode

Backend und Webanwendung lokal starten

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

Benötigt rustup, Node.js 26, Docker mit Compose und git im PATH. Das Skript startet PostgreSQL, wendet die Migrationen an und startet das Backend auf Port 8080 und den Angular-Entwicklungsserver auf Port 4201.

Installationsanleitung (auf Französisch)

Was danach passiert

1
Der Server verweigert den Start, solange ein Secret fehlt oder zu kurz ist: JWT_SECRET braucht mindestens 32 Zeichen, SETTINGS_ENCRYPTION_KEY genau 32.
2
Er verbindet sich mit PostgreSQL, wendet seine Migrationen an, legt den ersten Administrator an, wenn die Benutzertabelle leer ist, und lauscht auf Port 8080.
3
Die erste Anmeldung führt durch die Einrichtung einer Authenticator-App oder eines Passkeys und zeigt die zehn Wiederherstellungscodes. Es gibt keine Möglichkeit, diesen Schritt zu überspringen.

Voraussetzungen

Docker mit dem Compose-Plugin, oder einen Kubernetes-Cluster mit Traefik, einem CNI, das NetworkPolicy durchsetzt, und einer Standard-StorageClass.
PostgreSQL 18: Der Compose-Stack und das Chart bringen jeweils eine eigene Instanz mit.
Eine Domain und TLS davor, über einen Reverse-Proxy: FerrisGit terminiert HTTPS nicht selbst, und Passkeys funktionieren nur auf einem sicheren Origin.

FerrisGit evaluieren und die eigene Instanz betreiben.

Die öffentliche Instanz zeigt das Produkt. Die eigene Instanz behält den Code.

FerrisGit öffnen Installationsanleitung