Configuración

media-daemon (daemon)

Variables de entorno que lee media-daemon (daemon).

ImplementadoSin versión del tren todavía· generada desde scripts/docs/env.schema.ts

Página generada desde scripts/docs/env.schema.ts. No se edita a mano: bun run docs:gen la regenera y bun run docs:check falla si difiere.

73 variables.

VariableQué controlaDefectoMarcasLa leen
NATS_URLURL 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_SIZEDaemon: 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_SIZEDaemon: 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_DELAYDaemon: espera máxima, en ms, antes de exportar un lote OTLP incompleto (10 a 60000).5000—media-daemon (daemon)
OTEL_EXPORTER_OTLP_ENDPOINTEndpoint 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_ENDPOINTURL completa de los logs OTLP/HTTP del daemon; sustituye a OTEL_EXPORTER_OTLP_ENDPOINT + /v1/logs.——media-daemon (daemon)
OTEL_EXPORTER_OTLP_PROTOCOLDaemon: 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_TIMEOUTDaemon: 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_ENDPOINTURL completa de los spans OTLP/HTTP del daemon; sustituye a OTEL_EXPORTER_OTLP_ENDPOINT + /v1/traces.——media-daemon (daemon)
OTEL_INGEST_TOKENToken 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_DISABLEDDaemon: true o 1 apaga la exportación OTLP aunque haya endpoint.——media-daemon (daemon)
OTEL_SERVICE_NAMENombre de servicio en las trazas.el nombre del servicio (catalog-svc, …)—@styx/observability, @styx/service-http, media-daemon (daemon), web
SPIRE_KEYRINGKeyring 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_SEEDSemilla 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_SEEDSemilla 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_DIRDirectorio del anillo de caché L2 del daemon. Vacío o sin definir: sin caché L2.——media-daemon (daemon)
STYX_CONTROL_ALLOWED_GIDSGIDs (separados por comas) admitidos en el socket de control del daemon (SO_PEERCRED).(ninguno)—media-daemon (daemon)
STYX_CONTROL_ALLOWED_UIDSUIDs (separados por comas) admitidos en el socket de control del daemon (SO_PEERCRED).(ninguno)—media-daemon (daemon)
STYX_INGEST_LISTENDirección host:puerto del listener HTTP de ingesta conduit del daemon.127.0.0.1:8790—media-daemon (daemon)
STYX_INGEST_MAX_FILE_MIBFichero 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_MIBEspacio 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_PEERSBorde 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_PROOFPrueba 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_URLURL pública del listener de ingesta que se devuelve al cliente.——media-daemon (daemon)
STYX_INGEST_ROOTDirectorio raíz de ingesta del daemon. Sin él, la ingesta está desactivada.——media-daemon (daemon)
STYX_INGEST_ROOT_IDId 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_MIBBytes 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_ACTORSesiones 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_MIBEspacio total de staging de subidas en curso del daemon, en MiB.65536—media-daemon (daemon)
STYX_INGEST_STAGING_PER_ACTOR_MIBEspacio de staging por actor, en MiB.16384—media-daemon (daemon)
STYX_INGEST_TRUSTED_PROXIESIP 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_FORMATFormato 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_ORIGINSOrígenes (separados por comas) admitidos por los transportes web del daemon (WebTransport/HTTP3).(ninguno)—media-daemon (daemon)
STYX_MEDIA_CERTCertificado 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_ENGINEMotor de medios del daemon: zig, libav o auto (dec-0110).auto—media-daemon (daemon)
STYX_MEDIA_ENGINE_FALLBACKFallback 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_CERTCertificado del listener HTTP/3 de empaquetado.el de STYX_MEDIA_CERT—media-daemon (daemon)
STYX_MEDIA_H3_KEYClave del listener HTTP/3.la de STYX_MEDIA_KEY—media-daemon (daemon)
STYX_MEDIA_H3_PORTPuerto UDP del listener HTTP/3 (HLS/CMAF).4435—media-daemon (daemon)
STYX_MEDIA_KEYClave privada TLS de los listeners QUIC del daemon.clave de desarrollo de spikes/f0b-owned-media-path—media-daemon (daemon)
STYX_MEDIA_METRICS_INTERVAL_MSCada cuánto el daemon publica métricas, en ms. 0 las desactiva.0—media-daemon (daemon)
STYX_MEDIA_MOQT_FIXTUREAuto-publisher MoQT de desarrollo: <rootId>/<relPath> del fichero que publica.—sólo devmedia-daemon (daemon)
STYX_MEDIA_PACKAGING_HELD_MIBMemoria retenida por empaquetados en curso, en MiB.768—media-daemon (daemon)
STYX_MEDIA_PACKAGING_IDLE_SSegundos 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_MAXEmpaquetados abiertos a la vez en el daemon.32—media-daemon (daemon)
STYX_MEDIA_PACKAGING_WORKERSHilos de empaquetado del daemon.2—media-daemon (daemon)
STYX_MEDIA_SOCKETRuta 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_ADDRESSConexiones 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_SVCAnuncia HTTP/3 con Alt-Svc: h3=":<puerto UDP>" en cada respuesta del origen TCP (on | off).on—media-daemon (daemon)
STYX_MEDIA_TCP_CERTCertificado (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_SSegundos entre lecturas del certificado del origen TCP (0 = nunca).30—media-daemon (daemon)
STYX_MEDIA_TCP_KEYClave privada (PEM) del origen TCP.la de STYX_MEDIA_H3_KEY—media-daemon (daemon)
STYX_MEDIA_TCP_MAX_PER_ADDRESSConexiones 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_PORTPuerto 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_PORTPuerto 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_TLSTLS 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_HOSTHost del listener WebTransport del daemon.localhost—media-daemon (daemon)
STYX_MEDIA_WT_IPV6Familia 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_PORTPuerto UDP del listener WebTransport.4433—media-daemon (daemon)
STYX_MOQT_CERTCertificado del listener MoQT.el de STYX_MEDIA_CERT—media-daemon (daemon)
STYX_MOQT_IPV6Familia 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_KEYClave del listener MoQT.la de STYX_MEDIA_KEY—media-daemon (daemon)
STYX_MOQT_PORTPuerto UDP del listener MoQT.4434—media-daemon (daemon)
STYX_NODE_IDId del nodo del daemon: audiencia que exige a las SCT.styx-media-daemon—media-daemon (daemon)
STYX_SCT_PUBLIC_KEYSClaves 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_MINHarness de soak de caché: activa la salida de depuración.—sólo devmedia-daemon (daemon)
STYX_SOAK_HOT_SETHarness de soak de caché: cardinalidad del conjunto de claves calientes.256sólo devmedia-daemon (daemon)
STYX_SOAK_L1_BYTESHarness de soak de caché: capacidad de L1 (RAM) en bytes.8388608 (8 MiB)sólo devmedia-daemon (daemon)
STYX_SOAK_L2_BYTESHarness de soak de caché: capacidad de L2 (NVMe) en bytes.67108864 (64 MiB)sólo devmedia-daemon (daemon)
STYX_SOAK_RING_DIRHarness de soak de caché: directorio del anillo L2.—sólo devmedia-daemon (daemon)
STYX_SOAK_SECONDSHarness de soak de caché: duración total de la ejecución en segundos.30sólo devmedia-daemon (daemon)
STYX_SOAK_SEEDHarness de soak de caché: semilla del PRNG.0xCAFE_F00D_DEAD_BEEFsólo devmedia-daemon (daemon)
STYX_SOAK_VAL_BYTESHarness de soak de caché: tamaño en bytes de cada valor que se inserta.4096sólo devmedia-daemon (daemon)