Variables de entorno que lee media-daemon (daemon).
scripts/docs/env.schema.tsPágina generada desde
scripts/docs/env.schema.ts. No se edita a mano:bun run docs:genla regenera ybun run docs:checkfalla si difiere.
73 variables.
| Variable | Qué controla | Defecto | Marcas | La leen |
|---|---|---|---|---|
NATS_URL | URL del servidor NATS del bus (spire, dec-0120). | nats://localhost:4222 | — | @styx/bus, catalog-svc, identity-svc, media-daemon (daemon), playback-svc, realtime-svc, sources-svc, web, workers-svc |
OTEL_BSP_MAX_EXPORT_BATCH_SIZE | Daemon: registros por lote de la exportación OTLP (spans y logs). Entre 1 y 256 (dec-0135 D4). | 128 | — | media-daemon (daemon) |
OTEL_BSP_MAX_QUEUE_SIZE | Daemon: capacidad de la cola de exportación OTLP; llena, se descarta y se cuenta. Entre 16 y 8192 (dec-0135 D4). | 1024 | — | media-daemon (daemon) |
OTEL_BSP_SCHEDULE_DELAY | Daemon: espera máxima, en ms, antes de exportar un lote OTLP incompleto (10 a 60000). | 5000 | — | media-daemon (daemon) |
OTEL_EXPORTER_OTLP_ENDPOINT | Endpoint OTLP de trazas. Sin él, OpenTelemetry queda desactivado. Los servicios usan el gRPC del colector (4317); el daemon exporta spans y logs por OTLP/HTTP JSON a <endpoint>/v1/traces y /v1/logs y necesita el receptor HTTP (4318), en http:// (dec-0135 D4). | — | — | @styx/observability, media-daemon (daemon) |
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT | URL completa de los logs OTLP/HTTP del daemon; sustituye a OTEL_EXPORTER_OTLP_ENDPOINT + /v1/logs. | — | — | media-daemon (daemon) |
OTEL_EXPORTER_OTLP_PROTOCOL | Daemon: grpc apaga su exportación OTLP (sólo habla OTLP/HTTP); cualquier otro valor se acepta y se responde con JSON. | — | — | media-daemon (daemon) |
OTEL_EXPORTER_OTLP_TIMEOUT | Daemon: plazo, en ms, de cada POST OTLP (100 a 30000). Un endpoint que falla entra en backoff. | 10000 | — | media-daemon (daemon) |
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT | URL completa de los spans OTLP/HTTP del daemon; sustituye a OTEL_EXPORTER_OTLP_ENDPOINT + /v1/traces. | — | — | media-daemon (daemon) |
OTEL_INGEST_TOKEN | Token con el que los servicios y el daemon se autentican contra el colector OTel. El daemon lo lee de OTEL_INGEST_TOKEN_FILE; en claro lo rechaza. | — | secreto (_FILE) | @styx/observability, catalog-svc, identity-svc, media-daemon (daemon), playback-svc, realtime-svc, sources-svc, web, workers-svc |
OTEL_SDK_DISABLED | Daemon: true o 1 apaga la exportación OTLP aunque haya endpoint. | — | — | media-daemon (daemon) |
OTEL_SERVICE_NAME | Nombre de servicio en las trazas. | el nombre del servicio (catalog-svc, …) | — | @styx/observability, @styx/service-http, media-daemon (daemon), web |
SPIRE_KEYRING | Keyring de spire: claves públicas de los emisores del bus con las que se verifican los sobres firmados (dec-0120). | — | — | @styx/bus, media-daemon (daemon) |
SPIRE_NATS_NKEY_SEED | Semilla NKey del usuario NATS del servicio (ACL por servicio generada de BUS_ROUTES). Obligatoria en producción. | — | secreto (_FILE) | @styx/bus, catalog-svc, identity-svc, media-daemon (daemon), playback-svc, realtime-svc, sources-svc, web, workers-svc |
SPIRE_SEED | Semilla de la identidad de spire del servicio: firma los sobres del bus. | — | obligatoria, secreto (_FILE) | @styx/bus, catalog-svc, identity-svc, media-daemon (daemon), playback-svc, realtime-svc, sources-svc, web, workers-svc |
STYX_CACHE_L2_DIR | Directorio del anillo de caché L2 del daemon. Vacío o sin definir: sin caché L2. | — | — | media-daemon (daemon) |
STYX_CONTROL_ALLOWED_GIDS | GIDs (separados por comas) admitidos en el socket de control del daemon (SO_PEERCRED). | (ninguno) | — | media-daemon (daemon) |
STYX_CONTROL_ALLOWED_UIDS | UIDs (separados por comas) admitidos en el socket de control del daemon (SO_PEERCRED). | (ninguno) | — | media-daemon (daemon) |
STYX_INGEST_LISTEN | Dirección host:puerto del listener HTTP de ingesta conduit del daemon. | 127.0.0.1:8790 | — | media-daemon (daemon) |
STYX_INGEST_MAX_FILE_MIB | Fichero más grande que se admite en una subida, en MiB. playback-svc y el daemon aplican el mismo tope. | 16384 | — | media-daemon (daemon), playback-svc |
STYX_INGEST_MIN_FREE_MIB | Espacio libre, en MiB, que el volumen de la raíz de ingesta conserva: el daemon no arranca la ingesta si no caben el staging entero más este suelo, y rechaza con 507 un create que lo dejaría por debajo. | 2048 | — | media-daemon (daemon) |
STYX_INGEST_PEERS | Borde del listener de ingesta: proxy (detrás del proxy de STYX_INGEST_TRUSTED_PROXIES con STYX_INGEST_PROXY_PROOF) o direct. Obligatoria si el listener no es loopback o si hay proxy o prueba configurados. | — | — | media-daemon (daemon) |
STYX_INGEST_PROXY_PROOF | Prueba que el proxy de entrada añade a las peticiones de ingesta hacia el daemon (STYX_INGEST_PROXY_PROOF_FILE). | — | secreto (_FILE) | media-daemon (daemon) |
STYX_INGEST_PUBLIC_URL | URL pública del listener de ingesta que se devuelve al cliente. | — | — | media-daemon (daemon) |
STYX_INGEST_ROOT | Directorio raíz de ingesta del daemon. Sin él, la ingesta está desactivada. | — | — | media-daemon (daemon) |
STYX_INGEST_ROOT_ID | Id de la raíz de ingesta del daemon (dec-0121). playback-svc y el daemon tienen que coincidir. | ingest | — | media-daemon (daemon), playback-svc |
STYX_INGEST_ROOT_MAX_MIB | Bytes totales guardados en la raíz de ingesta, en MiB. playback-svc y el daemon aplican el mismo tope. | 131072 | — | media-daemon (daemon), playback-svc |
STYX_INGEST_SESSIONS_PER_ACTOR | Sesiones de ingesta a la vez por actor. playback-svc y el daemon aplican el mismo tope. | 4 | — | media-daemon (daemon), playback-svc |
STYX_INGEST_STAGING_MIB | Espacio total de staging de subidas en curso del daemon, en MiB. | 65536 | — | media-daemon (daemon) |
STYX_INGEST_STAGING_PER_ACTOR_MIB | Espacio de staging por actor, en MiB. | 16384 | — | media-daemon (daemon) |
STYX_INGEST_TRUSTED_PROXIES | IP del proxy de confianza delante del listener de ingesta (un host, no una subred ni una lista). Con STYX_INGEST_PEERS=proxy, exige STYX_INGEST_PROXY_PROOF. | — | — | media-daemon (daemon) |
STYX_LOG_FORMAT | Formato de los logs: json (una línea JSON por registro con trace_id/span_id, para docker logs) o pretty. Por defecto json con NODE_ENV=production. | — | — | @styx/observability, media-daemon (daemon), web |
STYX_MEDIA_ALLOWED_ORIGINS | Orígenes (separados por comas) admitidos por los transportes web del daemon (WebTransport/HTTP3). | (ninguno) | — | media-daemon (daemon) |
STYX_MEDIA_CERT | Certificado TLS de los listeners QUIC del daemon (también el de MoQT y HTTP/3 si no se fijan aparte). | certificado de desarrollo de spikes/f0b-owned-media-path | — | media-daemon (daemon) |
STYX_MEDIA_ENGINE | Motor de medios del daemon: zig, libav o auto (dec-0110). | auto | — | media-daemon (daemon) |
STYX_MEDIA_ENGINE_FALLBACK | Fallback de motor cuando el elegido no puede con un fichero: off o libav (dec-0110 §3). Un valor que el binario no puede cumplir detiene el daemon al arrancar. | off | — | media-daemon (daemon) |
STYX_MEDIA_H3_CERT | Certificado del listener HTTP/3 de empaquetado. | el de STYX_MEDIA_CERT | — | media-daemon (daemon) |
STYX_MEDIA_H3_KEY | Clave del listener HTTP/3. | la de STYX_MEDIA_KEY | — | media-daemon (daemon) |
STYX_MEDIA_H3_PORT | Puerto UDP del listener HTTP/3 (HLS/CMAF). | 4435 | — | media-daemon (daemon) |
STYX_MEDIA_KEY | Clave privada TLS de los listeners QUIC del daemon. | clave de desarrollo de spikes/f0b-owned-media-path | — | media-daemon (daemon) |
STYX_MEDIA_METRICS_INTERVAL_MS | Cada cuánto el daemon publica métricas, en ms. 0 las desactiva. | 0 | — | media-daemon (daemon) |
STYX_MEDIA_MOQT_FIXTURE | Auto-publisher MoQT de desarrollo: <rootId>/<relPath> del fichero que publica. | — | sólo dev | media-daemon (daemon) |
STYX_MEDIA_PACKAGING_HELD_MIB | Memoria retenida por empaquetados en curso, en MiB. | 768 | — | media-daemon (daemon) |
STYX_MEDIA_PACKAGING_IDLE_S | Segundos sin una sola petición tras los que el daemon cierra y revoca una sesión empaquetada (30 a 600: nunca más de lo que vive un SCT read). | 600 | — | media-daemon (daemon) |
STYX_MEDIA_PACKAGING_MAX | Empaquetados abiertos a la vez en el daemon. | 32 | — | media-daemon (daemon) |
STYX_MEDIA_PACKAGING_WORKERS | Hilos de empaquetado del daemon. | 2 | — | media-daemon (daemon) |
STYX_MEDIA_SOCKET | Ruta del socket Unix de control del daemon (spire, dec-0120). | /tmp/styx-media-daemon.sock | — | catalog-svc, media-daemon (daemon), playback-svc |
STYX_MEDIA_TCP_ACCEPT_RATE_PER_ADDRESS | Conexiones nuevas por segundo que una dirección puede abrir en el origen TCP (cada una cuesta un handshake TLS en el hilo del loop); 0 = sin tope. Mismo aviso que STYX_MEDIA_TCP_MAX_PER_ADDRESS detrás de un proxy. | 32 | — | media-daemon (daemon) |
STYX_MEDIA_TCP_ALT_SVC | Anuncia HTTP/3 con Alt-Svc: h3=":<puerto UDP>" en cada respuesta del origen TCP (on | off). | on | — | media-daemon (daemon) |
STYX_MEDIA_TCP_CERT | Certificado (PEM, cadena completa) del origen TCP. Se relee cada STYX_MEDIA_TCP_CERT_RELOAD_S y, si cambió y la clave le corresponde, los handshakes siguientes usan el nuevo. | el de STYX_MEDIA_H3_CERT | — | media-daemon (daemon) |
STYX_MEDIA_TCP_CERT_RELOAD_S | Segundos entre lecturas del certificado del origen TCP (0 = nunca). | 30 | — | media-daemon (daemon) |
STYX_MEDIA_TCP_KEY | Clave privada (PEM) del origen TCP. | la de STYX_MEDIA_H3_KEY | — | media-daemon (daemon) |
STYX_MEDIA_TCP_MAX_PER_ADDRESS | Conexiones abiertas que una dirección puede tener en el origen TCP; 0 = sin tope. Detrás de un proxy sin PROXY protocol todos los espectadores son una dirección: súbelo o ponlo a 0. | 16 | — | media-daemon (daemon) |
STYX_MEDIA_TCP_PORT | Puerto TCP del origen HTTPS del daemon (HTTP/1.1 sobre TLS 1.3, dec-0134). off o 0 lo desactiva. | el de STYX_MEDIA_H3_PORT | — | media-daemon (daemon) |
STYX_MEDIA_TCP_PUBLIC_PORT | Puerto que los clientes marcan para el origen TCP cuando no es el enlazado (un proxy en 443); es el que anuncia el descriptor de entrega. | el puerto TCP enlazado | — | media-daemon (daemon) |
STYX_MEDIA_TCP_TLS | TLS en el origen TCP (on | off). off sirve HTTP/1.1 en claro, sólo detrás de un proxy que termina TLS en una red privada. | on | — | media-daemon (daemon) |
STYX_MEDIA_WT_HOST | Host del listener WebTransport del daemon. | localhost | — | media-daemon (daemon) |
STYX_MEDIA_WT_IPV6 | Familia del socket del listener WebTransport: 1 exige dual-stack, 0 sólo IPv4; sin definir, dual-stack si el kernel tiene IPv6. Un valor inválido o imposible deshabilita el listener. | — | — | media-daemon (daemon) |
STYX_MEDIA_WT_PORT | Puerto UDP del listener WebTransport. | 4433 | — | media-daemon (daemon) |
STYX_MOQT_CERT | Certificado del listener MoQT. | el de STYX_MEDIA_CERT | — | media-daemon (daemon) |
STYX_MOQT_IPV6 | Familia del socket del listener MoQT: 1 exige dual-stack, 0 sólo IPv4; sin definir, dual-stack si el kernel tiene IPv6. Un valor inválido o imposible deshabilita el listener. | — | — | media-daemon (daemon) |
STYX_MOQT_KEY | Clave del listener MoQT. | la de STYX_MEDIA_KEY | — | media-daemon (daemon) |
STYX_MOQT_PORT | Puerto UDP del listener MoQT. | 4434 | — | media-daemon (daemon) |
STYX_NODE_ID | Id del nodo del daemon: audiencia que exige a las SCT. | styx-media-daemon | — | media-daemon (daemon) |
STYX_SCT_PUBLIC_KEYS | Claves públicas Ed25519 (con su kid) con las que el daemon verifica las SCT (dec-0117 §4.1). | (ninguna: deny-by-default) | — | media-daemon (daemon) |
STYX_SOAK_DEBUG_MIN | Harness de soak de caché: activa la salida de depuración. | — | sólo dev | media-daemon (daemon) |
STYX_SOAK_HOT_SET | Harness de soak de caché: cardinalidad del conjunto de claves calientes. | 256 | sólo dev | media-daemon (daemon) |
STYX_SOAK_L1_BYTES | Harness de soak de caché: capacidad de L1 (RAM) en bytes. | 8388608 (8 MiB) | sólo dev | media-daemon (daemon) |
STYX_SOAK_L2_BYTES | Harness de soak de caché: capacidad de L2 (NVMe) en bytes. | 67108864 (64 MiB) | sólo dev | media-daemon (daemon) |
STYX_SOAK_RING_DIR | Harness de soak de caché: directorio del anillo L2. | — | sólo dev | media-daemon (daemon) |
STYX_SOAK_SECONDS | Harness de soak de caché: duración total de la ejecución en segundos. | 30 | sólo dev | media-daemon (daemon) |
STYX_SOAK_SEED | Harness de soak de caché: semilla del PRNG. | 0xCAFE_F00D_DEAD_BEEF | sólo dev | media-daemon (daemon) |
STYX_SOAK_VAL_BYTES | Harness de soak de caché: tamaño en bytes de cada valor que se inserta. | 4096 | sólo dev | media-daemon (daemon) |