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.

Seguir trabajando con esta página

Instrucciones listas para tu herramienta de IA. Copia, pega y empieza: la IA obtiene el contenido por sí misma mediante la dirección incluida en el texto.

Resumir los pasos para mí Lo esencial, en el orden correcto.

Abrir en ChatGPT

Lee la siguiente documentación de tolinax UG y trabaja con ella.

Esta página: https://ayoune.com/es/docs/self-hosting/self-hosting-bersicht.md
La colección completa: https://ayoune.com/es/docs/self-hosting.md

Resume el contenido para mí.

- Primero, en dos frases: ¿de qué trata esto?
- Después, los pasos en el orden en que debo darlos.
- Una línea por paso, en lenguaje sencillo.
- Al final: qué debería tener preparado de antemano.

No omitas nada que necesite para terminar de verdad.
Nota sobre las fuentes:
- Cada página de esta documentación está disponible como Markdown (la misma dirección con `.md`).
- Hay un resumen legible por máquina de todo el contenido público en `/llms.txt`.
- Si tienes acceso al servidor MCP de aYOUne, puedes trabajar con datos en vivo
  en lugar de esta instantánea. Si no, ignora este punto.

Explicar para qué necesito esto Para qué sirve y cuándo merece la pena.

Abrir en ChatGPT

Lee la siguiente documentación de tolinax UG y trabaja con ella.

Esta página: https://ayoune.com/es/docs/self-hosting/self-hosting-bersicht.md
La colección completa: https://ayoune.com/es/docs/self-hosting.md

Explícame para qué necesito esto.

1. ¿Qué problema resuelve? En una frase, desde mi punto de vista.
2. Tres situaciones típicas en las que realmente me ayuda.
3. Cuándo NO lo necesito: eso me ahorra tiempo.
4. Qué puedo hacer en su lugar si no encaja.

Cíñete a lo que dice la fuente. Donde no aporte nada, dilo abiertamente en vez
de suponer.
Nota sobre las fuentes:
- Cada página de esta documentación está disponible como Markdown (la misma dirección con `.md`).
- Hay un resumen legible por máquina de todo el contenido público en `/llms.txt`.
- Si tienes acceso al servidor MCP de aYOUne, puedes trabajar con datos en vivo
  en lugar de esta instantánea. Si no, ignora este punto.

Ayudarme con la configuración Paso a paso, preguntándome sobre la marcha.

Abrir en ChatGPT

Lee la siguiente documentación de tolinax UG y trabaja con ella.

Esta página: https://ayoune.com/es/docs/self-hosting/self-hosting-bersicht.md
La colección completa: https://ayoune.com/es/docs/self-hosting.md

Acompáñame paso a paso durante la configuración.

- Dime primero qué necesito tener preparado (accesos, datos, tiempo).
- Después guíame de UN paso en UN paso. Espera a que te diga "siguiente".
- En cada paso, indica cómo puedo saber que ha funcionado.
- Si algo falla, pídeme el mensaje exacto en vez de suponer.

Si las instrucciones dejan algo abierto, dímelo en lugar de inventarlo.
Nota sobre las fuentes:
- Cada página de esta documentación está disponible como Markdown (la misma dirección con `.md`).
- Hay un resumen legible por máquina de todo el contenido público en `/llms.txt`.
- Si tienes acceso al servidor MCP de aYOUne, puedes trabajar con datos en vivo
  en lugar de esta instantánea. Si no, ignora este punto.

Ayudarme con un problema Acotar la causa en vez de adivinar.

Abrir en ChatGPT

Lee la siguiente documentación de tolinax UG y trabaja con ella.

Esta página: https://ayoune.com/es/docs/self-hosting/self-hosting-bersicht.md
La colección completa: https://ayoune.com/es/docs/self-hosting.md

Ayúdame a acotar un problema.

- Pregúntame primero qué observo y qué esperaba en su lugar.
- A partir de ahí, deduce las causas más probables acordes con esta fuente.
- Para cada causa, dame UNA prueba que la confirme o la descarte.
- Ordénalas de modo que la prueba más barata vaya primero.

No adivines. Si la fuente no cubre el problema, dime dónde debería seguir
buscando.
Nota sobre las fuentes:
- Cada página de esta documentación está disponible como Markdown (la misma dirección con `.md`).
- Hay un resumen legible por máquina de todo el contenido público en `/llms.txt`.
- Si tienes acceso al servidor MCP de aYOUne, puedes trabajar con datos en vivo
  en lugar de esta instantánea. Si no, ignora este punto.

Explicarlo con palabras sencillas Sin tecnicismos, desde cero.

Abrir en ChatGPT

Lee la siguiente documentación de tolinax UG y trabaja con ella.

Esta página: https://ayoune.com/es/docs/self-hosting/self-hosting-bersicht.md
La colección completa: https://ayoune.com/es/docs/self-hosting.md

Explica el contenido de modo que lo entienda alguien sin conocimientos previos.

- Empieza por el propósito: ¿para qué existe esto?
- Explica los tecnicismos en media frase la primera vez que aparezcan.
- Una comparación cotidiana donde de verdad funcione, ninguna donde cojee.
- Al final: las tres cosas que conviene recordar.

No acortes omitiendo condiciones. Una simplificación que oculta un requisito es
una afirmación falsa.
Nota sobre las fuentes:
- Cada página de esta documentación está disponible como Markdown (la misma dirección con `.md`).
- Hay un resumen legible por máquina de todo el contenido público en `/llms.txt`.
- Si tienes acceso al servidor MCP de aYOUne, puedes trabajar con datos en vivo
  en lugar de esta instantánea. Si no, ignora este punto.

Una lista para ir marcando Para seguirla mientras lo haces.

Abrir en ChatGPT

Lee la siguiente documentación de tolinax UG y trabaja con ella.

Esta página: https://ayoune.com/es/docs/self-hosting/self-hosting-bersicht.md
La colección completa: https://ayoune.com/es/docs/self-hosting.md

Conviértelo en una **lista de verificación** para la puesta en práctica.

- Exactamente una acción por punto, en imperativo.
- Ordénala de modo que ningún punto dependa de un requisito posterior.
- Requisitos y escollos como subpuntos con sangría.
- Termina con una comprobación: ¿cómo sé que todo está correcto?
Nota sobre las fuentes:
- Cada página de esta documentación está disponible como Markdown (la misma dirección con `.md`).
- Hay un resumen legible por máquina de todo el contenido público en `/llms.txt`.
- Si tienes acceso al servidor MCP de aYOUne, puedes trabajar con datos en vivo
  en lugar de esta instantánea. Si no, ignora este punto.

Was this article helpful?

👎 No (0)