Saltar al contenido principal

Solución de problemas del autoalojamiento

Empieza por los logs: docker compose logs --tail=200 app. Aumenta el detalle con LOG_LEVEL=debug (y vuelve a dejarlo como estaba después).

La app no arranca​

  • El log menciona una variable de entorno: falta una variable obligatoria o es demasiado corta: APP_URL (una URL completa), DATABASE_URL, AUTH_SECRET (16 caracteres o más), APP_ENCRYPTION_KEY (32 caracteres o más). Consulta Configuración.
  • No se puede acceder a la base de datos: comprueba con docker compose ps que el servicio db está en buen estado (healthy), y que POSTGRES_PASSWORD no ha cambiado desde que se creó la base de datos (la contraseña solo se define en el primer arranque con un volumen vacío).
  • Falla una migración: no edites la base de datos a mano. Restaura la copia de seguridad de antes de la actualización y luego informa del error con las líneas del log.

Comprueba si está lista con curl -fsS http://127.0.0.1:3000/api/ready.

Problemas de inicio de sesión​

  • Te redirige a una dirección equivocada o las cookies no se guardan: APP_URL debe ser exactamente la dirección HTTPS pública, y el proxy debe transmitir X-Forwarded-Proto (Proxy inverso y TLS).
  • "Demasiados intentos" para todo el mundo: todas las peticiones parecen venir de una sola dirección. Corrige el tratamiento de X-Forwarded-For en el proxy y TRUST_PROXY_HOPS (Direcciones IP de los clientes).
  • El inicio de sesión único falla después de la página del proveedor: la URI de redirección registrada en el proveedor debe coincidir exactamente con la que aparece en Administración → Autenticación; usa Probar conexión para comprobar el emisor.
  • Las llaves de acceso han dejado de funcionar: ha cambiado el dominio de APP_URL. Cada persona vuelve a añadir sus llaves de acceso.
  • Sin acceso a ninguna cuenta de administración: crea o asciende a un Propietario desde la línea de comandos (Instalación).

No llegan los correos​

  • MAIL_DRIVER debe ser smtp; con log, los mensajes solo aparecen en el log de la app.
  • Busca errores de correo en el log (fallo de autenticación, conexión rechazada, errores de TLS). El puerto 465 necesita SMTP_SECURE=true; el puerto 587 necesita false.
  • Llegan, pero a spam: configura SPF, DKIM y DMARC para el dominio del remitente (Correo).
  • Cuentas nuevas atascadas en Revisa tu correo: necesitan el correo de confirmación. Arregla el envío o desactiva Exigir confirmación del correo en Administración → Autenticación (Confirmación del correo).

Fallan las subidas​

  • Fallan al momento con archivos grandes: el límite de cuerpo del proxy está por debajo del tamaño de bloque (el de nginx es 1 MB por defecto): Proxy inverso y TLS.
  • "Este archivo supera el límite de …": sube el tamaño máximo de archivo en Administración → General → Subidas. Un admin del espacio puede definir un límite más bajo para su espacio.
  • S3: las subidas funcionan, las descargas no: los navegadores deben poder llegar a la dirección del bucket; define S3_PUBLIC_ENDPOINT (Almacenamiento).
  • S3: tamaño de bloque rechazado: S3 necesita bloques de al menos 5 MB.

No se entregan los webhooks​

  • La instancia o el espacio tienen los webhooks desactivados (Administración → General → API, o los ajustes del espacio).
  • El destino está en una red privada: solo se permite con Permitir webhooks a direcciones de red privadas.
  • Un webhook que falla 20 veces seguidas se desactiva solo; vuelve a activarlo después de arreglar el receptor. Consulta Webhooks.

¿Sigues atascado?​

Reúne la versión (SOL2FLOW_VERSION), las líneas del log relevantes (quita secretos y datos personales) y los pasos para reproducir el problema, y ponte en contacto con tu canal de soporte de sol2flow.