No está en su idioma

Esta página aún no está disponible en es. Está leyendo la versión de.

Environment Variables

Actualizado: 28/9/2026

Environment Variables

aYOUne verwendet eine einzelne ConfigMap (ayoune in K8s, .env in Compose) für alle Services. Das macht das Multi-Service-Setup einfacher zu pflegen — eine Variable, die du einmal setzt, ist überall verfügbar.

Pflicht-Variablen

Variable	Default	Beschreibung
`MONGO_URL`	—	MongoDB-Connection-String (Replicaset!)
`REDIS_URL`	—	Redis-Connection (`redis://...`)
`JWT_SECRET`	—	Min. 32 Zeichen, geheim
`AYOUNE_VERSION`	aktuelle	Plattform-Version (für Audit-Tagging)
`LICENSE_KEY`	trial	HMAC-SHA256 License-Key
`BASE_URL`	—	Public-Hostname (z.B. `https://app.firma.tld`)

Optionale Foundation

Variable	Default	Beschreibung
`MONGO_DB_NAME`	`ayoune`	DB-Name innerhalb des Replicasets
`REDIS_DB`	0	Redis-Logical-DB
`JWT_REFRESH_SECRET`	= `JWT_SECRET`	Eigenes Secret für Refresh-Tokens
`JWT_ACCESS_TTL`	`15m`	Access-Token Lebensdauer
`JWT_REFRESH_TTL`	`30d`	Refresh-Token Lebensdauer
`STORAGE_TYPE`	`gcs`	`gcs` / `s3` / `local`
`STORAGE_BUCKET`	—	Bucket-Name

Module-spezifisch

Variable	Modul	Zweck
`OPENAI_API_KEY`	ai	Default LLM-Provider
`ANTHROPIC_API_KEY`	ai	Claude-Models
`STRIPE_SECRET_KEY`	payments	Stripe-Charges
`PAYPAL_CLIENT_ID`	payments	PayPal-Webhooks
`TWILIO_ACCOUNT_SID`	notifications	SMS / Voice
`SENDGRID_API_KEY`	notifications	Mail-Versand
`VAPID_PUBLIC` / `VAPID_PRIVATE`	notifications	Web-Push
`GOOGLE_CLOUD_PROJECT`	infrastructure	GCP-Auth
`AYOUNE_WORKER_PROBE_PORT`	core	Worker-Probe-Port (default 3000)
`AYOUNE_RELEASE_NAME`	core	Scope-Name für `registerModuleStates`

Service-Discovery

Im K8s-Setup verbinden sich Services intern via DNS — kein extra Setup nötig:

api-crm.develop.svc.cluster.local:3000

Im Compose-Setup nutzt jedes Service den Namen aus docker-compose.yml:

api-crm:3000

CORS

Variable	Default	Beschreibung
`CORS_ORIGIN_OVERRIDE`	—	Komma-Liste zusätzlicher Origins (überspringt `aYOUneCustomers.allowedOrigins[]`)
`CORS_ALLOW_CREDENTIALS`	`true`	`Access-Control-Allow-Credentials`

Boot-Watchdog

Seit Core 2026.46.0 killt ein 60s-Boot-Watchdog Pods, deren essentielle Init-Phase (DB + Models + License) nicht durchläuft. Tuning:

AYOUNE_BOOT_WATCHDOG_MS=60000   # default
AYOUNE_BOOT_WATCHDOG_DISABLED=false

Background-Subsysteme (Logger, JobQ, Monitoring) blocken ay.ready nicht — Probleme dort tauchen als subsystem_error auf, nicht als Crash.

Secrets via External-Secret-Manager

Statt Plain-Text-Secrets in Compose/Helm:

GKE: Secret-Manager mit Workload-Identity
Hetzner: HCP Vault Secrets oder bitwarden secrets
AWS: Secrets Manager

Die ConfigMap enthält dann nur Referenzen, kein Klartext.

Siehe auch: Docker-Compose, Kubernetes, Upgrades.

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/environment-variables.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/environment-variables.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/environment-variables.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/environment-variables.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/environment-variables.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/environment-variables.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)