ArtiFerrisInstallazione

Installazione

ArtiFerris sta in un'immagine container: il server, i due registry, l'interfaccia e Trivy. Ha bisogno di PostgreSQL e di un volume. Tre modi di installarlo: Docker Compose, il chart Helm su Kubernetes, o dai sorgenti.

Docker Compose

Avviare lo stack 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 costruisce l'immagine dai sorgenti, Trivy compreso. Generare i segreti con openssl rand -base64 48, e POSTGRES_PASSWORD con openssl rand -hex 24, poiché finisce in un URL.

Guida all'installazione

Chart Helm

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

Il chart genera la password del database, JWT_SECRET e SECRETS_ENCRYPTION_KEY e li ritrova da un deployment all'altro. Con helm template, Argo CD o Flux, impostarli manualmente. Il dominio di base serve ai sottodomini delle organizzazioni.

Guida all'installazione

Dai sorgenti

Avviare il backend e l'applicazione web in locale

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

Servono rustup, Node.js 26 e Docker con Compose. Lo script avvia PostgreSQL, applica le migrazioni e avvia il backend sulla porta 8081 e il server di sviluppo Angular sulla porta 4200.

Guida all'installazione

Cosa succede dopo

1
Il server si rifiuta di avviarsi se JWT_SECRET o SECRETS_ENCRYPTION_KEY è più corto di 32 byte o inizia con change-me, se la password del primo amministratore è ancora quella dell'esempio, o se PUBLIC_URL punta a 0.0.0.0.
2
Si connette a PostgreSQL, applica le migrazioni, crea il primo amministratore se la tabella degli utenti è vuota, e resta in ascolto sulla porta 8080.
3
Il primo accesso guida nella registrazione di un'app di autenticazione o di una passkey, e mostra i dieci codici di riserva. Non c'è modo di evitarlo.

Requisiti

Docker con il plugin Compose, o un cluster Kubernetes con Traefik per l'ingress.
PostgreSQL 18: lo stack Compose e il chart includono il proprio.
Un volume persistente per gli archivi npm e i blob Docker: l'archiviazione è un file system locale, servito da una sola replica.
Un nome di dominio, un sottodominio per organizzazione, e TLS davanti, tramite un reverse proxy. Le passkey funzionano soltanto su un'origine sicura.

Provare ArtiFerris, poi distribuire la propria istanza.

L'istanza pubblica permette di scoprire il prodotto. La propria istanza conserva i propri pacchetti.

Apri ArtiFerris Guida all'installazione