Self-Hosting Übersicht

aYOUne läuft "as-a-Service" bei Tolinax — du kannst es aber auch komplett selbst hosten. Auf einem Single-Host (Docker-Compose) für kleine Setups, auf Kubernetes (Helm-Charts) für Multi-Region und High-Availability. Diese KB führt dich durch beide Welten.

Wann selbst hosten?

Szenario	Empfehlung
Pilot, < 10 User, < 1 GB Daten	Single-Host (Compose)
Production, < 100 User	Single-Host (Compose) auf großem Server
Production, 100–10 000 User	K8s (Hetzner/GKE/AKS)
Geo-Compliance (z.B. EU-only)	Eigene K8s-Region
Air-Gapped / On-Premise	Compose mit lokalem Mirror

Die SaaS-Variante (*.ayoune.app) bleibt natürlich der einfachste Weg — kein Ops, automatische Updates.

Inhaltsverzeichnis

Thema	Beschreibung
Erste Schritte	Voraussetzungen, `ay setup`
Docker-Compose	Profile, `dev.ps1`
Kubernetes	Helm-Charts, GKE/Hetzner
Environment Variables	Vollständige ENV-Matrix
Upgrades	`ay self-host-update`
Troubleshooting	Pod-Crashloops, Probes

Architektur in 30 Sekunden

aYOUne besteht aus ~330 Microservices, die über drei Klassen verteilt sind:

┌─────────────────────┐
│  Frontend Apps      │  Angular 21 (admin-v2, mobile-app, consumer-app, …)
├─────────────────────┤
│  Module-APIs        │  Express + Mongoose (crm-api, cms-api, marketing-api, …)
│  Workers            │  BullMQ (worker-notifications, worker-rag, …)
│  Gateways           │  WebSocket, pub/sub, notifier
├─────────────────────┤
│  Foundation         │  MongoDB Atlas + Redis + GCS/S3
└─────────────────────┘

Jeder Microservice ist:

TypeScript / Node 20 (node --no-deprecation dist/server.js unter dumb-init)
Default Port 3000
Single ConfigMap (ayoune) — siehe Environment Variables
Health-Probes via /healthz (process-alive) + /readyz (AY.ready latch) seit Core 2026.46.0

License-Modell

Self-Hosted-Instanzen brauchen eine License-Key (HMAC-SHA256). Gratis 14-Tage-Trial; danach Tolinax-Lizenz pro Modul. Setup via LICENSE_KEY ENV oder ay self-host-update license <key>.

Nächster Schritt

Erste Schritte — Voraussetzungen klären und ay setup ausführen.