Documentación · Ayuda

Solución de problemas frecuentes

Cómo resolver errores de certificados auto-firmados, HTTP en red privada, claves SSH cambiadas, cuotas de Gemini y Drive.

Guía rápida para los avisos más habituales al configurar Portainer, SSH, IA híbrida o copias en Google Drive.

Error de certificado SSL o TLS en Portainer

Síntoma: aparece Error de certificado SSL. Habilita "Permitir Inseguro".

Causas y solución:

  • Si tu instancia usa HTTPS con certificado auto-firmado (propio de Portainer en el puerto 9443), edita el servidor y activa Permitir certificados auto-firmados.
  • Si usas un proxy inverso (Caddy, Traefik, Nginx) con certificado válido, comprueba que la URL coincida exactamente con el dominio del certificado y que el reloj del dispositivo tenga fecha correcta.

HTTP bloqueado al conectar a una IP o dominio

Síntoma: la app rechaza una URL http:// fuera de tu red local.

Por qué ocurre: CleartextGuard bloquea HTTP sin cifrar hacia direcciones públicas para proteger tokens y contraseñas. Solo permite HTTP en localhost, dominios .local y rangos privados RFC 1918 (10.x.x.x, 172.16.x.x–172.31.x.x, 192.168.x.x). Usa https:// o accede a través de VPN privada (WireGuard / Tailscale).

La terminal SSH rechaza el servidor por cambio de clave

Síntoma: la huella del host SSH no coincide con la guardada anteriormente (TOFU mismatch).

Qué revisar:

  1. Si reinstalaste el sistema operativo o regeneraste /etc/ssh/ssh_host_*, verifica la nueva huella ejecutando en tu servidor ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub.
  2. Solo si confirmas que el cambio es legítimo, actualiza la confianza del host. Si no hiciste cambios en el servidor, no aceptes la conexión hasta descartar un intermediario en la red.

Cuota agotada o modelo ocupado en Gemini BYOK

Síntoma: Tu clave de Gemini no tiene cuota para este modelo... o La IA en la nube está saturada.

  • Pulsa Comprobar mi clave en Configuración → Integración con AI para verificar de forma estimada si tu clave pertenece a la capa gratuita o de pago.
  • Si alcanzaste el límite diario en un modelo concreto, cambia a otro modelo marcado como disponible en la lista o usa un modelo local Gemma 4 (Pro).

Error al restaurar copia de Google Drive

Síntoma: Contraseña incorrecta o copia dañada.

  • Las copias de appDataFolder se cifran localmente con AES-256 usando exactamente la contraseña maestra introducida al crearlas. Comprueba mayúsculas, espacios o un PIN anterior. No existe recuperación externa de esa contraseña.

Cómo reportar un problema técnico desde la app

Si encuentras un fallo o cierre inesperado:

  1. Abre Ajustes → Reportar un problema dentro de STALMAS.
  2. Describe brevemente qué ocurrió y elige si quieres adjuntar los errores técnicos registrados por la app (y, si usas IA local, los datos técnicos del modelo activo y su acelerador).
  3. Pulsa Ver informe para revisar el texto completo: STALMAS oculta automáticamente direcciones IP, dominios privados, contraseñas y tokens antes de preparar el borrador.
  4. Pulsa Enviar para abrir tu aplicación de correo hacia report@stalmas.app (o copiar el borrador al portapapeles si no tienes cliente de correo). También puedes consultar nuestra página de soporte.