FerrisGitInstalación

Instalación

FerrisGit se despliega como una imagen de contenedor acompañada de PostgreSQL. Hay tres formas de instalarlo: Docker Compose, el chart de Helm en Kubernetes o desde el código fuente.

Docker Compose

Arrancar la pila 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 construye la imagen desde el código. Para usar la imagen publicada, sustituye build: . por image: masmarino/ferrisgit:0.1.3 en docker-compose.yml.

Guía de instalación (en francés)

Chart de Helm

Instalar el chart en 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

Si se dejan vacíos, el chart genera la contraseña de la base de datos, JWT_SECRET, SETTINGS_ENCRYPTION_KEY y la contraseña del primer administrador en el Secret ferrisgit-secrets. La release debe llamarse ferrisgit.

Despliegue en Kubernetes (en francés)

Desde el código

Ejecutar el backend y la aplicación 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

Hacen falta rustup, Node.js 26, Docker con Compose y git en el PATH. El script arranca PostgreSQL, aplica las migraciones y ejecuta el backend en el puerto 8080 y el servidor de desarrollo de Angular en el puerto 4201.

Guía de instalación (en francés)

Qué pasa después

1
El servidor se niega a arrancar mientras falte un secreto o sea demasiado corto: JWT_SECRET necesita 32 caracteres o más, SETTINGS_ENCRYPTION_KEY exactamente 32.
2
Se conecta a PostgreSQL, aplica sus migraciones, crea el primer administrador si la tabla de usuarios está vacía y escucha en el puerto 8080.
3
El primer inicio de sesión guía en la activación de una aplicación de autenticación o de una passkey, y muestra los diez códigos de respaldo. No hay forma de omitirlo.

Requisitos

Docker con el plugin Compose, o un clúster Kubernetes con Traefik, un CNI que aplique NetworkPolicy y una StorageClass por defecto.
PostgreSQL 18: la pila Compose y el chart traen el suyo.
Un dominio y TLS delante, mediante un proxy inverso: FerrisGit no termina HTTPS por sí mismo, y las passkeys solo funcionan en un origen seguro.

Evaluar FerrisGit y desplegar una instancia propia.

La instancia pública permite conocer el producto. Una instancia propia conserva el código.

Abrir FerrisGit Guía de instalación