ArtiFerrisInstalación

Instalación

ArtiFerris cabe en una imagen de contenedor: el servidor, los dos registros, la interfaz y Trivy. Necesita PostgreSQL y un volumen. Tres formas de instalarlo: Docker Compose, el chart de Helm en Kubernetes, o desde el código.

Docker Compose

Arrancar la pila con Docker Compose

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

Compose construye la imagen desde el código, Trivy incluido. Genere los secretos con openssl rand -base64 48, y POSTGRES_PASSWORD con openssl rand -hex 24, ya que acaba en una URL.

Guía de instalación

Chart de Helm

Instalar el chart en Kubernetes

git clone https://github.com/Masmarino/ArtiFerris.git
cd ArtiFerris
helm upgrade --install artiferris ./helm/artiferris \
  --namespace artiferris --create-namespace \
  --set image.tag=0.6.1 \
  --set ingress.host=app.example.com --set ingress.wildcardHost='*.example.com' \
  --set artiferris.baseDomain=example.com

El chart genera la contraseña de la base de datos, JWT_SECRET y SECRETS_ENCRYPTION_KEY y los recupera de un despliegue a otro. Con helm template, Argo CD o Flux, fíjelos usted mismo. El dominio base sirve para los subdominios de las organizaciones.

Guía de instalación

Desde el código

Ejecutar el backend y la aplicación web en local

git clone https://github.com/Masmarino/ArtiFerris.git
cd ArtiFerris
cp .env.example .env          # then set POSTGRES_PASSWORD and JWT_SECRET
./scripts/dev.sh              # PostgreSQL via Compose, the backend on :8081, ng serve on :4200

Necesita rustup, Node.js 26 y Docker con Compose. El script arranca PostgreSQL, aplica las migraciones y ejecuta el backend en el puerto 8081 y el servidor de desarrollo de Angular en el puerto 4200.

Guía de instalación

Qué pasa después

1
El servidor se niega a arrancar si JWT_SECRET o SECRETS_ENCRYPTION_KEY tiene menos de 32 bytes o empieza por change-me, si la contraseña del primer administrador sigue siendo la del ejemplo, o si PUBLIC_URL apunta a 0.0.0.0.
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 le guía para registrar una aplicación de autenticación o una clave de acceso, y muestra sus diez códigos de respaldo. No hay forma de saltárselo.

Requisitos

Docker con el plugin Compose, o un clúster de Kubernetes con Traefik para el ingress.
PostgreSQL 18: la pila de Compose y el chart traen el suyo.
Un volumen persistente para los archivos npm y los blobs Docker: el almacenamiento es un sistema de archivos local, servido por una sola réplica.
Un nombre de dominio, un subdominio por organización, y TLS delante, mediante un proxy inverso. Las claves de acceso solo funcionan en un origen seguro.

Evalúe ArtiFerris y luego despliegue su propia instancia.

La instancia pública permite descubrir el producto. Su instancia conserva sus paquetes.

Abrir ArtiFerris Guía de instalación