ArtiFerrisInstallation

Installation

ArtiFerris passt in ein Container-Image: der Server, beide Registries, die Oberfläche und Trivy. Es braucht PostgreSQL und ein Volume. Drei Installationswege: Docker Compose, das Helm-Chart auf Kubernetes oder aus dem Quellcode.

Docker Compose

Den Stack mit Docker Compose starten

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 baut das Image aus dem Quellcode, Trivy inklusive. Erzeugen Sie die Geheimnisse mit openssl rand -base64 48 und POSTGRES_PASSWORD mit openssl rand -hex 24, da es in einer URL landet.

Installationsanleitung

Helm-Chart

Das Chart auf Kubernetes installieren

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

Das Chart erzeugt das Datenbankpasswort, JWT_SECRET und SECRETS_ENCRYPTION_KEY und findet sie von einem Deployment zum nächsten wieder. Mit helm template, Argo CD oder Flux legen Sie sie selbst fest. Die Basisdomain dient den Subdomains der Organisationen.

Installationsanleitung

Aus dem Quellcode

Backend und Webanwendung lokal starten

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

Sie benötigen rustup, Node.js 26 und Docker mit Compose. Das Skript startet PostgreSQL, wendet die Migrationen an und startet das Backend auf Port 8081 und den Angular-Entwicklungsserver auf Port 4200.

Installationsanleitung

Was danach passiert

1
Der Server startet nicht, wenn JWT_SECRET oder SECRETS_ENCRYPTION_KEY kürzer als 32 Byte ist oder mit change-me beginnt, wenn das Passwort des ersten Administrators noch das des Beispiels ist oder wenn PUBLIC_URL auf 0.0.0.0 zeigt.
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 Sie durch die Einrichtung einer Authenticator-App oder eines Passkeys und zeigt Ihre zehn Backup-Codes an. Es gibt keinen Weg daran vorbei.

Voraussetzungen

Docker mit dem Compose-Plugin oder ein Kubernetes-Cluster mit Traefik für den Ingress.
PostgreSQL 18: Der Compose-Stack und das Chart bringen ihr eigenes mit.
Ein persistentes Volume für die npm-Archive und die Docker-Blobs: Der Speicher ist ein lokales Dateisystem, von einem einzigen Replikat bedient.
Ein Domainname, eine Subdomain pro Organisation und TLS davor, über einen Reverse Proxy. Passkeys funktionieren nur auf einem sicheren Ursprung.

Testen Sie ArtiFerris, dann betreiben Sie Ihre eigene Instanz.

Die öffentliche Instanz dient zum Kennenlernen. Ihre eigene Instanz verwahrt Ihre Pakete.

ArtiFerris öffnen Installationsanleitung