aYOUne
translate
Not in your language

This page is not yet available in en. You're reading the de version.

Self-Hosting Erste Schritte

Dieser Guide führt dich durch ein Single-Host-Setup mit Docker-Compose. Lesezeit + Setup-Zeit: ~30 Minuten.

Voraussetzungen

Komponente Version Hinweis
Linux/macOS/Windows aktueller Kernel Windows: WSL2
Docker ≥ 24 mit Compose-V2
Node.js ≥ 20 für die ay-CLI
MongoDB 6 oder 7 als Container oder extern (Atlas)
Redis ≥ 7 als Container reicht
Storage 50 GB+ für Compose-Volumes
RAM 8 GB+ abhängig von aktivierten Profilen

Für ein Test-Setup reicht ein Mini-PC oder eine kleine VM (z.B. Hetzner CX31). Production sollte 16 GB+ haben.

CLI installieren

npm install -g @tolinax/ayoune-cli
ay --version            # 2026.x.y

Mehr unter CLI Install — die CLI ist der Türöffner für alle Self-Hosting-Operationen.

Setup-Wizard

ay setup

Der Wizard fragt dich der Reihe nach:

  1. Hostname der Instanz (z.B. ayoune.firma.tld)
  2. MongoDB-URL (mongodb://... oder mongodb+srv://...)
  3. Redis-URL (redis://localhost:6379)
  4. License-Key (Trial: leer lassen, du bekommst 14 Tage)
  5. Profile — welche Domänen-Module starten? (core, crm, marketing, ...)
  6. JWT-Secret (auto-generiert, aber überschreibbar)
  7. TLS — Caddy (Let's-Encrypt), Traefik oder eigener Reverse-Proxy?

Nach Bestätigung schreibt der Wizard:

~/.aYOUne/
├── docker-compose.yml      # erzeugt aus deiner Auswahl
├── .env                    # Geheimnisse + Hosts
└── data/
    ├── mongo/
    └── redis/

Ersten Start

ay status                  # zeigt: alle services down
docker compose up -d       # ODER: ay local up
ay status                  # zeigt: services starting → healthy

Sobald alle Services healthy sind, erreichst du die Plattform unter https://<hostname>.

Initial-Login

Standard-Bootstrapping legt einen Superuser an:

ay setup bootstrap-superuser \
  --email admin@firma.tld \
  --password 'SehrSicher!2026'

Logge dich ein, lege deinen ersten Customer + die ersten User an. Mehr unter Admin-Handbook → Erste Schritte.

Häufige Stolpersteine

  • MongoDB-Replicaset: aYOUne nutzt Change-Streams — eine Standalone-MongoDB funktioniert NICHT. Mindest-Setup: rs0-Replicaset.
  • Redis-Persistence: Aktiviere AOF (appendonly yes) für Production — sonst gehen Queue-Jobs nach Restart verloren.
  • TLS: Ohne HTTPS keine PWA-Features (Service-Worker, Push-Notifications). Nutze Caddy oder einen vorgelagerten Reverse-Proxy.

Nächste Schritte