Le pedimos a Gemini, la inteligencia artificial de Google que nos explique cómo solucionar problmas de osticket en linux
Explicanos detalladamente cómo solucionar problmas de osticket en linuxAunque osTicket es famoso por ser el "tanque" de los Help Desks —pesa poco y aguanta mucho—, no es inmune a los caprichos de las actualizaciones de PHP o a los bloqueos de seguridad de los servidores de correo modernos.
Si tu sistema de tickets ha empezado a dar errores o se ha quedado "mudo", aquí tienes la guía técnica para diagnosticarlo y repararlo.
1. El Oráculo: Los Logs de Errores
En osTicket, la información de lo que falla está repartida en tres lugares. Debes revisarlos en este orden:
Log Interno de osTicket: Si puedes entrar al panel, ve a Panel de Administración > Diagnóstico > Registros del sistema. Aquí verás errores de login, fallos en el envío de correos y alertas de seguridad.
Log de Apache/Nginx: Si ves un error "500 Internal Server Error", la respuesta está aquí.
Bash
sudo tail -f /var/log/apache2/error.log
Log de MySQL: Si el problema es que no se guardan los tickets o las búsquedas fallan.
Bash
sudo tail -f /var/log/mysql/error.log
2. Pantalla Blanca (WSOD) tras Actualizar
Si después de actualizar PHP o el propio osTicket ves una página en blanco, el problema suele ser una extensión de PHP faltante o un error de sintaxis que PHP no se atreve a mostrar.
La solución
Asegúrate de tener instaladas las extensiones vitales. osTicket 1.17+ es muy estricto con php-apcu, php-intl y php-zend-opcache.
Verifica los módulos activos:
Bash
php -m | grep -E "imap|gd|intl|xml|mbstring"
Si falta alguno, instálalo (ej. sudo apt install php-intl) y reinicia Apache.
3. El Problema #1: Los correos no se descargan
Este es el fallo más común. osTicket no "escucha" los correos en tiempo real; espera a que alguien (el servidor) le dé un "toque".
Causa A: El Cron Job se detuvo.
Verifica si el cron está activo para el usuario web:
Bash
sudo crontab -u www-data -l
Si no ves la línea de api/cron.php, el sistema no está procesando el correo de fondo.
Causa B: El "Auto-Cron" está desactivado.
Si no usas una tarea programada en Linux, asegúrate de que en Ajustes > Correos electrónicos esté marcada la opción "Obtener correos electrónicos mediante el autocron". Nota: Esto solo funciona cuando un agente humano está navegando por el panel.
4. Error de Permisos en ost-config.php
osTicket es muy "quisquilloso" con la seguridad de su archivo de configuración. Si ves un aviso persistente en el panel o el sistema no te deja guardar cambios:
El archivo debe tener permisos de lectura pero no de escritura para el servidor web una vez instalado.
Bash
sudo chmod 644 /var/www/html/osticket/upload/include/ost-config.php
Si necesitas cambiar la configuración de la base de datos, cámbialo temporalmente a 666, guarda y vuelve a 644.
5. Problemas con la Base de Datos (MySQL)
Si el error dice "Error connecting to database", verifica estos tres puntos:
Espacio en disco: Si el disco está al 100%, MySQL no puede crear archivos temporales y se bloquea. Usa df -h.
Modo SQL : Las versiones nuevas de MySQL son muy estrictas. Si ves errores de "Strict Mode", intenta editar tu my.cnf para relajar las reglas o asegúrate de que osTicket esté actualizado a la última versión compatible con tu versión de MySQL.
Reparación de tablas: Si hubo un apagón, las tablas pueden marcarse como corruptas.
SQL
REPAIR TABLE ost_ticket, ost_ticket_thread;
6. Problemas con OAuth2 (Gmail/Microsoft 365)
Desde que Google y Microsoft eliminaron la "autenticación básica", configurar el correo en osTicket se volvió un dolor de cabeza.
Síntoma: El sistema funcionaba y de pronto dejó de recibir correos.
Solución
Asegúrate de tener instalado el plugin oficial de OAuth2 en la carpeta include/plugins.
Verifica que el Token no haya expirado. A veces hay que entrar al panel de Azure o Google Cloud y refrescar el "Secret Key" porque caducó tras un año.
Tabla de Referencia Rápida
Si vas a realizar cualquier cambio importante, ve a la carpeta de osTicket y haz un backup rápido de la base de datos:
mysqldump -u usuario -p base_de_datos > backup_fecha.sql
osTicket es muy agradecido; una vez que los permisos y el cron están bien configurados, puede pasar años sin dar un solo problema. Pero si ves que el sistema se vuelve inestable tras subir muchos archivos, revisa la carpeta /attachments (si usas el plugin de almacenamiento en disco), porque si esa carpeta pierde permisos, el sistema se colapsa al intentar escribir un nuevo ticket.
¿Te está dando algún error específico de autenticación LDAP o es más un problema de configuración de SMTP para enviar correos?