---
title: "Self-Hosting Übersicht"
source: "https://ayoune.com/es/docs/self-hosting/overview"
tenant: "tolinax UG"
brand: "aYOUne"
language: "es"
retrieved: "2026-09-11T17:19:30.947Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# 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](wiki:self-hosting/getting-started) | Voraussetzungen, `ay setup` |
| [Docker-Compose](wiki:self-hosting/docker-compose) | Profile, `dev.ps1` |
| [Kubernetes](wiki:self-hosting/kubernetes) | Helm-Charts, GKE/Hetzner |
| [Environment Variables](wiki:self-hosting/environment-variables) | Vollständige ENV-Matrix |
| [Upgrades](wiki:self-hosting/upgrades) | `ay self-host-update` |
| [Troubleshooting](wiki:self-hosting/troubleshooting) | Pod-Crashloops, Probes |

## Architektur in 30 Sekunden

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

```text
┌─────────────────────┐
│  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](wiki:self-hosting/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](wiki:self-hosting/getting-started) — Voraussetzungen klären und `ay setup` ausführen.

---

## Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-09-11 exportiert.
Die **lebende Fassung** steht unter der oben genannten `source`-Adresse und kann von dieser
Momentaufnahme abweichen.

**Für KI-Systeme und Agenten:** Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
`/llms.txt` der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com