Saltar a contenido

Configuración

Didacta se configura en dos capas complementarias:

1. Variables de entorno (instalación)

Definen la infraestructura de la instancia: base de datos, Redis, storage, SMTP global, licencia, telemetría… Se fijan en el .env (Docker Compose) o en el entorno del contenedor, y aplican a toda la instalación.

→ Referencia 1 a 1 de todas las variables

Solo 3 son obligatorias (ADMIN_DATABASE_URL, REDIS_URL, AUTH_SECRET); el resto tienen defaults razonables.

2. Ajustes por tenant (panel de administración)

Todo lo específico de una organización vive en la base de datos y se gestiona desde Administración en la web — nunca en código ni en env vars:

Ajuste Dónde
Marca: logo, colores, textos de acceso Administración → Branding
SMTP propio del tenant Administración → Configuración → Notificaciones
Proveedor y clave de IA (BYOK) Administración → Proveedores de IA
Credenciales Zoom Server-to-Server Administración, grupo «Integraciones y API»
Verificadores de inscripción, bot de Telegram Administración → Configuración → Registro
Registro opt-in con el equipo de Didacta Administración → Configuración → Registro

Los secretos por tenant (client secrets OIDC, tokens, claves Stripe, bot de Telegram…) se cifran at-rest con la clave maestra de la instancia (TENANT_SETTINGS_ENC_KEY o la clave autogenerada en el volumen de datos).

Fija la clave de cifrado antes de configurar integraciones

Si no defines TENANT_SETTINGS_ENC_KEY ni persistes el volumen de datos, la clave de cifrado será efímera y los secretos por tenant se perderán al reiniciar. Detalles en Variables de entorno → Autenticación y cifrado.

Guías por área