FerrisGitInstallazione

Installazione

FerrisGit si distribuisce come immagine container, affiancata da PostgreSQL. Tre modalità di installazione: Docker Compose, il chart Helm su Kubernetes o i sorgenti.

Docker Compose

Avviare lo stack con 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 costruisce l'immagine dai sorgenti. Per usare l'immagine pubblicata, sostituisci build: . con image: masmarino/ferrisgit:0.1.3 in docker-compose.yml.

Guida all'installazione (in francese)

Chart Helm

Installare il chart su 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

Se lasciati vuoti, il chart genera la password del database, JWT_SECRET, SETTINGS_ENCRYPTION_KEY e la password del primo amministratore nel Secret ferrisgit-secrets. La release deve chiamarsi ferrisgit.

Deployment su Kubernetes (in francese)

Dai sorgenti

Avviare backend e applicazione web in locale

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

Servono rustup, Node.js 26, Docker con Compose e git nel PATH. Lo script avvia PostgreSQL, applica le migrazioni e lancia il backend sulla porta 8080 e il server di sviluppo Angular sulla porta 4201.

Guida all'installazione (in francese)

Cosa succede dopo

1
Il server rifiuta di partire finché un segreto manca o è troppo corto: JWT_SECRET richiede almeno 32 caratteri, SETTINGS_ENCRYPTION_KEY esattamente 32.
2
Si collega a PostgreSQL, applica le migrazioni, crea il primo amministratore se la tabella degli utenti è vuota, e ascolta sulla porta 8080.
3
Il primo accesso guida nell'attivazione di un'app di autenticazione o di una passkey e mostra i dieci codici di recupero. Non c'è modo di saltare questo passaggio.

Requisiti

Docker con il plugin Compose, oppure un cluster Kubernetes con Traefik, un CNI che applichi le NetworkPolicy e una StorageClass predefinita.
PostgreSQL 18: lo stack Compose e il chart portano il proprio.
Un dominio e TLS davanti, tramite un reverse proxy: FerrisGit non termina HTTPS da solo, e le passkey funzionano solo su un'origine sicura.

Valutare FerrisGit, poi distribuire la propria istanza.

L'istanza pubblica consente di conoscere il prodotto. La propria istanza custodisce il codice.

Apri FerrisGit Guida all'installazione