Cómo instalar y configurar Exim en linux

 Le pedimos a Gemini, la inteligencia artificial de Google, que nos explique cómo instalar y configurar Exim en linux

Explicanos detalladamente cómo instalar y configurar Exim en linux

Si Postfix es el chico popular y estructurado del mundo de los Mail Transfer Agents ( MTA ), Exim es el veterano de configuración flexible. Es el servidor de correo por defecto en sistemas como Debian y es famoso porque su archivo de configuración no es un simple listado de variables, sino casi un lenguaje de programación en sí mismo. Esto lo hace increíblemente potente, pero también intimidante si no se aborda con orden.

Si Postfix es el chico estructurado y popular de los servidores de correo, Exim es el veterano académico de configuración ultra-flexible. Es el Agente de Transferencia de Correo (MTA) por defecto en sistemas basados en Debian y Ubuntu. Su fama radica en que su archivo de configuración no es un simple listado de variables, sino casi un lenguaje de programación propio.

Esto lo hace increíblemente potente para filtrar correos o crear reglas complejas, pero también puede ser intimidante. Afortunadamente, Linux tiene herramientas para hacernos la vida más fácil. Aquí tienes la guía paso a paso.  

A continuación, te detallo cómo instalarlo, configurarlo (aprovechando las herramientas interactivas de Linux) y gestionar su cola de correo.

1. El Concepto: Monolítico vs. Dividido

Antes de instalar, debes saber algo crítico sobre Exim en Debian/Ubuntu: no se configura editando directamente su archivo final. El sistema te da a elegir entre tener la configuración en un solo gran archivo base (/etc/exim4/exim4.conf.template) o dividida en docenas de pequeños archivos dentro de /etc/exim4/conf.d/. Para empezar, el enfoque de archivo único (monolítico) es mucho más fácil de manejar.

2. Instalación de Exim

En las distribuciones basadas en Debian/Ubuntu, Exim está dividido en paquetes según las necesidades de tu servidor (soporte para bases de datos, LDAP, etc.). Para la gran mayoría de escenarios, el paquete estándar es más que suficiente.

Ejecuta en tu terminal:

Bash

sudo apt install exim4-daemon-light mailutils -y

Instalamos mailutils para contar con el comando mail, que nos permitirá hacer pruebas de envío directamente desde la consola.

3. Configuración Asistida (El método recomendado)

Modificar el archivo de configuración de Exim a mano desde cero es una receta para el desastre si estás empezando. Por suerte, los sistemas basados en Debian incluyen un asistente interactivo espectacular que genera la configuración limpia por ti.

Inicia el asistente con el siguiente comando:

Bash

sudo apt-get update

sudo dpkg-reconfigure exim4-config

El asistente te hará una serie de preguntas clave. Aquí tienes cómo responder según tu objetivo:

Tipo de configuración: * Internet site (Sitio de Internet): Si tu servidor va a enviar y recibir correos directamente usando su propia IP pública.

Mail sent by smarthost (Envío mediante un smarthost): (El más común) Si vas a usar Exim para enviar correos de tus aplicaciones locales (como osTicket o Znuny), pero quieres que se desvíen a través de un servidor externo (como SendGrid, Mailgun o Gmail).

Nombre del sistema de correo: El FQDN de tu servidor (por ejemplo, servidor.tuempresa.com).

Direcciones IP en las que escuchar conexiones: Si solo lo usará el propio servidor para enviar alertas internas, pon 127.0.0.1. Si otros servidores de tu red le van a enviar correos, pon su IP de red local o déjalo en blanco para escuchar en todas.

Otros destinos para los que se acepta correo: Dominios locales que este Exim deba recibir.

Dividir la configuración en archivos pequeños: Selecciona No para mantener la configuración en un único archivo principal (/etc/exim4/exim4.conf.template), lo cual facilita las modificaciones manuales posteriores.

Vamos a instalar el paquete "light", que tiene todo lo necesario para enviar y recibir correos de internet o funcionar como un Smarthost (enviar correos a través de un tercero como SendGrid o Amazon SES).

Bash

sudo apt update

sudo apt install exim4-daemon-light mailutils -y

(Instalamos mailutils para tener el comando mail y poder hacer pruebas rápidas desde la consola).  

5. Configuración Asistida (La forma segura)

Modificar Exim desde cero es una receta para el dolor de cabeza. Utilizaremos el asistente interactivo de Debian, que generará una configuración limpia y segura.

Ejecuta el siguiente comando:

Bash

sudo dpkg-reconfigure exim4-config

Te aparecerá una interfaz gráfica en la terminal con varias pantallas. Estas son las respuestas clave según lo que busques:

Tipo de configuración general:

El sitio de Internet (Internet Site): Elígelo si tu servidor va a enviar correos directamente a otros servidores (Gmail, Outlook) usando su propia IP pública.

El correo se envía mediante un "smarthost" (Smarthost): Elígelo si vas a enviar los correos a través de una cuenta de Office365, Google Workspace, o un servicio SMTP externo.

Entrega local solamente (Local delivery only): Si es solo para alertas del propio sistema Linux a root.

Nombre de correo del sistema: Pon el FQDN de tu servidor (ej. servidor.tuempresa.com).

Direcciones IP a escuchar: Si quieres que aplicaciones de tu red local puedan usarlo, déjalo en blanco. Si es solo para el propio servidor, pon 127.0.0.1 ; ::1.

Otros destinos para los que se acepta correo: Los dominios de los que tu servidor será el receptor final.

Mantener la cantidad de consultas DNS al mínimo: Selecciona "No" a menos que estés en una conexión intermitente (como un módem por satélite).

Dividir la configuración en pequeños archivos: Selecciona No (para usar el archivo monolítico que mencionamos al principio).

6. Configuración Manual: Autenticación con un Smarthost (SMTP Externo)

Si en el paso anterior elegiste configurar Exim como Smarthost (para que use una cuenta de correo externa para los envíos masivos o de sistema), debes indicarle las credenciales de acceso.

Edita el archivo de contraseñas de Exim:

Bash

sudo nano /etc/exim4/passwd.client

Añade tus credenciales al final del archivo utilizando el siguiente formato:

Plaintext

*.tu-proveedor-smtp.com:usuario_o_api_key:tu_contraseña_o_secret

Por ejemplo, para SendGrid sería algo como: *.sendgrid.net:apikey:SG.XYZ...

Protege el archivo cambiando sus permisos para que solo Exim pueda leerlo:

Bash

sudo chown root:Debian-exim /etc/exim4/passwd.client

sudo chmod 640 /etc/exim4/passwd.client

Aplica los cambios regenerando la configuración de Exim:

Bash

sudo update-exim4.conf

sudo systemctl restart exim4

7. Configurar Credenciales (Solo si usas Smarthost)

Si en el paso anterior elegiste usar un proveedor externo (Smarthost), necesitas decirle a Exim tu usuario y contraseña.

Abre el archivo de contraseñas de clientes:

Bash

sudo nano /etc/exim4/passwd.client

Añade tu proveedor y credenciales al final del archivo usando este formato: objetivo:usuario:contraseña. Por ejemplo, para SendGrid:

Plaintext

*.sendgrid.net:apikey:SG.TuTokenSecreto...

Asegura el archivo para que ningún otro usuario del sistema pueda leer tus contraseñas:

Bash

sudo chown root:Debian-exim /etc/exim4/passwd.client

sudo chmod 640 /etc/exim4/passwd.client

8. El Paso Crítico: Aplicar Cambios

A diferencia de Dovecot o Apache, reiniciar el servicio de Exim no aplica los cambios de configuración. Primero debes compilar la plantilla que creamos en los pasos anteriores.

Bash

# 1. Compila la nueva configuración

sudo update-exim4.conf

# 2. Reinicia el servicio para que la lea

sudo systemctl restart exim4

9. Pruebas y Monitoreo

Para comprobar que Exim está funcionando, vamos a enviar un correo de prueba:

Bash

echo "Prueba de Exim en Linux" | mail -s "Hola desde Exim" tu-correo-personal@gmail.com

¿No llegó el correo? Mira los Logs

Exim registra absolutamente todo lo que hace en su archivo mainlog. Si hay un fallo de contraseñas o el puerto 25 está bloqueado por tu proveedor de nube, lo verás aquí:

Bash

sudo tail -f /var/log/exim4/mainlog

<= Indica que Exim recibió un correo de un usuario local.

=> Indica que Exim lo entregó con éxito al exterior.

Indica un error fatal (como conexión rechazada).

10. Verificación y Pruebas de Envío

Para comprobar que Exim está procesando las solicitudes correctamente, puedes enviar un correo de prueba desde la propia terminal:

Bash

echo "Este es un correo de prueba de Exim" | mail -s "Prueba de Servidor" tu-correo-personal@gmail.com

El rastreo en los Logs

Si el correo no llega a tu bandeja de entrada, la respuesta no estará en la consola, sino en el archivo de registro. Mantén el log abierto mientras realizas la prueba:

Bash

sudo tail -f /var/log/exim4/mainlog

Un mensaje con < = significa que Exim aceptó el correo localmente.

Un mensaje con => significa que el correo fue entregado con éxito al siguiente servidor.

Un mensaje con . significa que hubo un error crítico (como datos de autenticación erróneos).

11. Control de la Cola de Correo (Herramientas del Administrador)

Una de las mayores virtudes de Exim es el control absoluto que te da sobre los correos que se quedan "atascados" (por ejemplo, si intentaste enviar un correo a un dominio que no existe).

Acción	Comando	Descripción
Ver la cola	sudo mailq o sudo exim -bp	Muestra todos los correos retenidos y su ID único.
Forzar entrega	sudo exim -qf	Obliga a Exim a reintentar el envío de toda la cola inmediatamente.
Ver estadísticas	`sudo exim -bp	eximon`
Eliminar un correo	sudo exim -Mrm <ID-del-mensaje>	Borra de la cola un correo específico usando su ID.
Eliminar toda la cola	sudo exim -Mrm $(exq -i)	Limpieza total de la cola de mensajes acumulados.

Tabla de Mantenimiento Rápido

El control de la cola es una de las mayores fortalezas de Exim. Si los correos se atascan, usa estos comandos:

Acción	Comando	Para qué sirve
Ver la cola	sudo mailq o sudo exim -bp	Muestra los correos atrapados en el servidor y su ID.
Forzar el envío	sudo exim -qf	Obliga a Exim a intentar enviar toda la cola de inmediato.
Leer un correo	sudo exim -Mvb <ID-Mensaje>	Lee el contenido (cuerpo) de un correo atascado.
Borrar un correo	sudo exim -Mrm <ID-Mensaje>	Elimina un mensaje específico de la cola.

Un detalle técnico a tener en cuenta

A diferencia de otros servicios donde editas un archivo .conf y reinicias, en Exim (especialmente en Debian/Ubuntu) modificar directamente /etc/exim4/exim4.conf.template requiere que ejecutes obligatoriamente sudo update-exim4.conf antes de reiniciar el servicio. Si olvidas este comando, Exim seguirá ejecutando la versión antigua que tiene guardada en su memoria interna /var/lib/exim4/config.autogenerated.

¿Este servidor Exim lo vas a usar principalmente como un "Smarthost" para desviar correos de tus aplicaciones (como WordPress o Znuny) a través de un proveedor externo, o quieres que sea un servidor de correo autónomo de cara a internet?

¿Este servidor Exim lo estás configurando para integrarlo con Znuny/OTRS y manejar tickets, o tienes en mente montar un servicio de correo corporativo completo (junto con Dovecot)?

Cómo resolver problemas de Dovecot en linux

 Le pedimos a Gemini, la inteligencia artificial de Google nos explique cómo resolver problemas de Dovecot en linux

Explicanos detalladamente cómo resolver problemas de Dovecot en linux

Resolver problemas en Dovecot es, en esencia, un trabajo de rastreo de autenticación y de permisos de archivos. Dado que Dovecot es extremadamente modular, el 90% de los fallos ocurren cuando el "recepcionista" (el servidor de correo) no puede encontrar el buzón del usuario o no confía en sus credenciales.

Aquí tienes la guía técnica de diagnóstico, organizada de lo más simple a lo más complejo.

1. El Oráculo: Logs de Dovecot

No pierdas tiempo adivinando. Los logs de Dovecot son increíblemente detallados y te dirán exactamente si el problema es la contraseña, el certificado SSL o una ruta inexistente.

Ruta estándar: /var/log/mail.log o /var/log/mail.err.

Monitoreo en tiempo real (mientras intentas conectar desde tu móvil/PC):

Bash

sudo tail -f /var/log/mail.log

2. El Problema #1: "Credenciales rechazadas"

Si el cliente de correo te dice "Usuario o contraseña incorrectos", pero estás seguro de que son correctos, el problema suele ser la autenticación de texto plano o un desajuste en el mecanismo de autenticación.

Verifica la configuración: Abre /etc/dovecot/conf.d/10-auth.conf.

Solución: Asegúrate de que auth_mechanisms tenga lo básico:

Ini, TOML

auth_mechanisms = plain login

Si usas TLS: Asegúrate de que disable_plaintext_auth = yes esté habilitado (esto obliga a usar cifrado, lo cual es correcto).

3. El Problema #2: "Carpeta no encontrada" o error de buzón

Si el login funciona pero el cliente de correo se queda cargando eternamente o te dice "No se puede abrir el buzón", Dovecot no sabe dónde están los correos.

Diagnóstico: Verifica la ruta del buzón en /etc/dovecot/conf.d/10-mail.conf.

La configuración debe coincidir con tu sistema:

Ini, TOML

mail_location = maildir:~/Maildir

Si tus correos están en /var/mail/usuario, tu configuración debe reflejar eso.

Permisos (Crucial): Dovecot debe poder escribir en esa carpeta.

Bash

# Asegúrate de que el usuario sea el dueño

sudo chown -R usuario:usuario /home/usuario/Maildir

# Asegúrate de que tenga permisos de lectura/escritura

sudo chmod -R 700 /home/usuario/Maildir

4. Problemas con SSL/TLS (El error de "Conexión insegura")

Si tu servidor funciona bien con una IP local pero falla al conectarse desde fuera, es casi seguro que el cliente de correo rechaza el certificado SSL.

Diagnóstico: ¿El certificado está caducado?

Bash

sudo openssl x509 -in /etc/letsencrypt/live/tudominio.com/cert.pem -text -noout | grep "Not After"

Solución: Si usas Let's Encrypt, asegúrate de que Dovecot apunte a las rutas correctas en /etc/dovecot/conf.d/10-ssl.conf y que el usuario dovecot (o mail) tenga permiso de lectura sobre esos archivos de certificado.

5. El "Invisible": Postfix y Dovecot no se hablan

Si puedes entrar al correo pero no puedes enviar correos desde tu cliente, Postfix no está validando tus credenciales a través de Dovecot.

Diagnóstico: Verifica si el socket de autenticación de Dovecot está creando el archivo correctamente para que Postfix lo lea.

Revisa el socket en /etc/dovecot/conf.d/10-master.conf:

Ini, TOML

service auth {

   unix_listener /var/spool/postfix/private/auth {

      mode = 0660

      user = postfix

      group = postfix

    }

}

Tabla de Diagnóstico Rápido

Si el archivo no aparece en /var/spool/postfix/private/auth, Postfix nunca podrá autenticar a tus usuarios.

Síntoma	Causa Probable	Solución
Error de Auth al loguear	Desajuste en auth_mechanisms.	Revisar /etc/dovecot/conf.d/10-auth.conf.
Buzón vacío/Error de carpeta	mail_location mal configurado.	Corregir ruta en 10-mail.conf.
El servicio no arranca	Error de sintaxis en archivo .conf.	dovecot -n (te mostrará el error exacto).
Lentitud extrema	Indice de búsqueda de IMAP corrupto.	Borrar archivos dovecot.index* en la carpeta del usuario.

Un consejo de "viejo lobo" de sistemas

La herramienta más potente que tienes es el comando dovecot -n. Al ejecutarlo en la terminal, Dovecot te imprimirá toda su configuración activa filtrando los valores por defecto. Es decir, te mostrará exactamente qué líneas has cambiado o añadido. Si algo no funciona, es porque una de esas líneas está mal escrita o apunta a una ruta que no existe.

¿Estás intentando configurar un servidor con usuarios locales (que existen en /etc/passwd) o estás usando una base de datos SQL para gestionar los correos? (Si es SQL, el problema suele estar en la configuración del driver de la base de datos en dovecot-sql.conf).

Cómo instalar y configurar Dovecot en linux

 Le preguntamos a Gemini, la inteligencia artificila de Google, cómo instalar y configurar Dovecot en linux

Explicanos detallladamente cómo instalar y configurar Dovecot en linux

Si estás montando tu propio servidor de correo en Linux, Dovecot es una pieza innegociable. Si Postfix (o cualquier otro MTA) es el cartero que trae las cartas a la oficina, Dovecot es el recepcionista y los casilleros: se encarga de almacenar los correos de forma segura y permitir que tus usuarios los lean desde su móvil o cliente de correo (como Outlook o Thunderbird) usando IMAP o POP3.

Es rápido, increíblemente ligero y escala de maravilla. Vamos a ver cómo instalarlo y configurarlo detalladamente en Ubuntu/Debian usando el formato moderno de almacenamiento (Maildir).

1. El Ecosistema del Correo

Antes de tocar código, es vital entender dónde se posiciona Dovecot en la red:

2. Paso 1: Instalación de Dovecot

Instalaremos los paquetes base junto con los demonios para IMAP y POP3 (aunque hoy en día POP3 está casi en desuso, es bueno saber cómo activarlo).

Bash

sudo apt update

sudo apt install dovecot-core dovecot-imapd dovecot-pop3d -y

Al terminar, el servicio se iniciará automáticamente, pero estará usando una configuración genérica que no es segura.

3. Paso 2: Habilitar los Protocolos

La configuración de Dovecot está fragmentada en la carpeta /etc/dovecot/conf.d/ para que sea más modular, aunque el archivo maestro es /etc/dovecot/dovecot.conf.

Abre el archivo principal:

Bash

sudo nano /etc/dovecot/dovecot.conf

Busca la línea protocols (si está comentada con un #, quítalo) y asegúrate de que incluya los protocolos que necesitas:

Ini, TOML

protocols = imap pop3 lmtp

(LMTP es útil si planeas conectar Dovecot directamente con Postfix para la entrega local).

4. Paso 3: Configurar el Almacenamiento (Maildir)

Por defecto, muchos sistemas antiguos usan mbox (un solo archivo gigante para todos los correos), lo cual es una pesadilla de rendimiento. Nosotros usaremos Maildir, que crea un archivo individual por cada correo electrónico.

Abre el archivo de configuración de correo:

Bash

sudo nano /etc/etc/dovecot/conf.d/10-mail.conf

Modifica la directiva mail_location para que apunte al directorio del usuario:

Ini, TOML

mail_location = maildir:~/Maildir

Configura los privilegios mínimos para que Dovecot pueda gestionar los buzones sin problemas de permisos:

Ini, TOML

mail_privileged_group = mail

5. Paso 4: Autenticación de Usuarios

Queremos que los usuarios se autentiquen de forma segura utilizando las propias cuentas del sistema Linux (usuarios del archivo /etc/passwd).

Abre el archivo de autenticación:

Bash

sudo nano /etc/dovecot/conf.d/10-auth.conf

Descomenta o modifica la siguiente línea para prohibir textos planos si no hay cifrado activo (vital para la seguridad):

Ini, TOML

disable_plaintext_auth = yes

Asegúrate de que los mecanismos permitidos incluyan plain y login:

Ini, TOML

auth_mechanisms = plain login

6. Paso 5: Cifrado SSL/TLS (¡Obligatorio!)

Hacer correr un servidor de correo en el siglo XXI sin SSL es regalarle tus contraseñas a cualquiera. Vamos a configurar Dovecot para que use certificados válidos (puedes usar los de Let's Encrypt si ya los tienes).

Abre el archivo de SSL:

Bash

sudo nano /etc/dovecot/conf.d/10-ssl.conf

Fuerza el uso de SSL cambiando el parámetro a required:

Ini, TOML

ssl = required

Especifica las rutas de tu certificado y tu clave privada:

Ini, TOML

ssl_cert = </etc/letsencrypt/live/tudominio.com/fullchain.pem

ssl_key = </etc/letsencrypt/live/tudominio.com/privkey.pem

(Nota el carácter <; es obligatorio en la sintaxis de Dovecot para indicarle que lea el contenido del archivo).

7. Paso 6: Integración con Postfix (El socket de autenticación)

Si estás usando Postfix para enviar correos, este necesitará "preguntarle" a Dovecot si un usuario es legítimo antes de permitirle enviar un email hacia el exterior (SASL Auth).Abre el archivo maestro de sockets:

Bash

sudo nano /etc/dovecot/conf.d/10-master.conf

Busca la sección service auth y configúrala para que cree un socket compatible con Postfix dentro de su jaula de ejecución:

Ini, TOML service auth {

unix_listener /var/spool/postfix/private/auth {

mode = 0660

user = postfix

group = postfix

     }

}

8. Aplicar Cambios y Pruebas

Reinicia el servicio para que absorba toda la nueva configuración:

Bash

sudo systemctl restart dovecot

sudo systemctl status dovecot

Tabla de Puertos a abrir en tu Firewall (ufw)

Protocolo	Puerto	Tipo	Descripción
IMAPS	993	Seguro	IMAP sobre SSL/TLS (Recomendado)
POP3S	995	Seguro	POP3 sobre SSL/TLS
IMAP	143	Estándar	Solo funcionará si inicia una conexión cifrada vía STARTTLS

Para comprobar que el puerto seguro está escuchando desde el propio servidor, puedes ejecutar:

Bash

openssl s_client -connect localhost:993

Si te devuelve el certificado SSL y un saludo de Dovecot (* OK [CAPABILITY ...] Dovecot ready), tu servidor está listo para recibir conexiones de cualquier cliente de correo moderno.

Un consejo de "viejo lobo" de red

Si los correos no aparecen en el cliente de correo tras la configuración, el problema suele ser que la carpeta ~/Maildir no existe en el home del usuario o no tiene los permisos correctos. Dovecot intentará crearla automáticamente la primera vez que llegue un correo, pero si falla, puedes forzar su creación en los usuarios nuevos modificando el esqueleto del sistema en /etc/skel/Maildir/.

¿Estás configurando este servidor Dovecot para que trabaje en conjunto con Postfix utilizando usuarios locales del sistema, o estás planeando usar una base de datos MySQL/MariaDB para gestionar usuarios virtuales (sin cuenta en el Linux)?

Cómo solucionar problemas de Znuny en linux

Le preguntamos a Gemini, la inteligencia artificial de Google  cómo solucionar problemas de Zbuby en linux

Explicanos detalladamente cómo solucionar problemas de Znuny en linux

Cuando Znuny (el robusto sucesor de OTRS) decide ponerse difícil, generalmente no se debe a un fallo en su código, sino a una desincronización en su ecosistema: el demonio interno, los módulos de Perl, la caché o, el enemigo número uno de todo administrador de sistemas, los permisos de archivos.

Al ser un sistema de nivel empresarial basado en Perl, su arquitectura es muy estricta. Aquí tienes la guía técnica paso a paso para diagnosticar, depurar y solucionar problemas en Znuny como un experto.

1. La Herramienta Suprema: otrs.Console.pl

El 90% de las tareas de reparación en Znuny se gestionan desde su CLI integrada.

[!CRITICAL]

Regla de oro inquebrantable: Nunca ejecutes estos comandos como root. Si lo haces, cambiarás el propietario de los archivos de caché y el servidor web (Apache/Nginx) no podrá leerlos, provocando un Error 500 inmediato. Usa siempre el usuario otrs.

Bash

# Cambia al entorno del usuario otrs

sudo -u otrs /opt/otrs/bin/otrs.Console.pl

Si ejecutas este comando sin argumentos, desplegará el catálogo completo de herramientas de diagnóstico. Las más importantes para resolver problemas están bajo el espacio de nombres Maint::.

2. El Síntoma #1: Los tickets no se actualizan ni entran correos

Si la interfaz web funciona pero el sistema parece "sordo y mudo" (no descarga correos, no envía notificaciones, las tareas programadas no se ejecutan), el Znuny Daemon se ha detenido o está bloqueado.

El Daemon es el motor que procesa todas las colas de eventos en segundo plano.

Diagnóstico y solución:

Bash

# Verificar si el demonio está vivo

sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl status

# Si está detenido o responde de forma errática, reinícialo:

sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl stop

sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl start

3. El Clásico "Error 500" o Pantalla Blanca (Permisos)

Si acabas de restaurar una copia de seguridad, migrar el servidor o (accidentalmente) ejecutaste un comando como root, los permisos del sistema de archivos se habrán roto. Znuny bloquea la ejecución si detecta que el servidor web (www-data) no es dueño o no tiene acceso de lectura/escritura a sus directorios críticos.

La solución definitiva:

Znuny cuenta con un script especializado que restablece la estructura de permisos correcta para los directorios var/, Kernel/ y los archivos de configuración:

Bash

cd /opt/otrs

sudo bin/otrs.SetPermissions.pl --web-group=www-data

4. La Interfaz se ve "Rota" o los Menús no Despliegan

Si tras instalar un paquete (opm), actualizar el sistema o modificar el archivo Config.pm la web pierde los estilos CSS o el JavaScript falla, el problema está en la caché del Loader. Znuny precompila estos archivos para mejorar la velocidad.

Forzar la reconstrucción visual:

Bash

# 1. Eliminar la caché de datos general

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Cache::Delete

# 2. Limpiar la caché del cargador de CSS y JS

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Loader::CacheCleanup

# 3. Reconstruir la configuración del sistema

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Config::Rebuild

5. Atascos en la Cola de Correos (Mail Queue)

Si un agente envía un ticket con un archivo adjunto gigantesco o malformado, la cola de salida de correo puede atascarse, impidiendo que salgan las notificaciones del resto de los usuarios.

Comandos de rescate para el correo:

Bash

# Listar los correos retenidos en la cola de salida

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Email::MailQueue --list

# Forzar el envío de los correos pendientes

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Email::MailQueue --send

# Si un correo específico está rompiendo el bucle, puedes eliminarlo de la cola:

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Email::MailQueue --delete --message-id=X

6. Revisión de Dependencias de Perl tras una Actualización del SO

A veces, un comando general apt upgrade en el servidor Linux actualiza la versión de Perl o de sus librerías compartidas, dejando a Znuny sin acceso a módulos críticos (como los de conexión a bases de datos o encriptación SSL).

Verificar la salud de Perl:

Bash

sudo /opt/otrs/bin/otrs.CheckModules.pl

Revisa el output con atención. Si algún módulo marcado como Required aparece como Not installed, instálalo inmediatamente usando el gestor de paquetes de tu distribución (por ejemplo, sudo apt install libjson-xs-perl).

Tabla de Referencia Rápida de Errores

Qué observas	Causa probable	Acción correctora
Log: "Can't write /opt/otrs/var/..."	Conflicto de privilegios en Linux.	Ejecuta otrs.SetPermissions.pl.
"Database connection broken"	MariaDB se quedó sin conexiones o el paquete es muy grande.	Sube max_allowed_packet = 64M en tu my.cnf.
Falta el botón de "Responder"	El ticket está bloqueado por otro agente o la respuesta automática no tiene plantilla.	Revisa el estado del ticket en la DB o asigna una plantilla al flujo de trabajo.
Los cambios en el SysConfig no se aplican	La caché del despliegue sigue activa.	Ejecuta Maint::Config::Rebuild.

Dónde buscar si el sistema no arranca (Logs)

Si la pantalla sigue en blanco y la consola de Znuny no responde, el error está registrado a nivel de servidor web o de sistema operativo. Monitorea estos archivos en tiempo real mientras intentas recargar la página:

Log de Apache/Nginx: tail -f /var/log/apache2/error.log (Esencial para ver fallos de comunicación con mod_perl).

Log de Znuny: tail -f /opt/otrs/var/log/otrs.log (Ideal para ver rechazos de credenciales SMTP/IMAP).

¿Estás lidiando actualmente con un código de error específico en el archivo otrs.log o el problema comenzó inmediatamente después de aplicar una actualización del sistema operativo?

Cómo instalar y configurar Znuny en linux

 Le pedimos a Gemini, la inteligencia artificial de Google cómo instalar y configurar Znuny en linux

Explicanos detalladamente cómo instalar y configurar Znuny en linux

Znuny es el sucesor espiritual y el fork comunitario de OTRS. Es un sistema de gestión de servicios (ITSM) de "clase empresarial" que destaca por su potencia y modularidad. A diferencia de otras herramientas basadas en PHP, Znuny utiliza Perl, lo que requiere una configuración de servidor específica y robusta.

Aquí tienes la guía técnica detallada para desplegarlo en un entorno Linux (como Ubuntu 24.04/22.04).

1. El Ecosistema: Stack LAMP + Perl

Para que Znuny funcione, no basta con Apache y MariaDB ; necesitas un conjunto extenso de módulos de Perl que gestionan desde el procesamiento de XML hasta la comunicación con servidores de correo.

Instalación de dependencias

Ejecuta el siguiente comando para instalar el servidor web, la base de datos y las librerías necesarias:

Bash

sudo apt update

sudo apt install apache2 mariadb-server libapache2-mod-perl2 git -y

# Instalación de módulos de Perl críticos

sudo apt install libapache-dbi-perl libarchive-zip-perl libauthen-ntlm-perl libcgi-pm-perl libcrypt-openssl-rsa-perl libcrypt-ssleay-perl libdbd-mysql-perl libencode-hanextra-perl libgd-gd2-perl libgd-graph-perl libgd-text-perl libio-socket-ssl-perl libjson-xs-perl libmail-imapclient-perl libnet-dns-perl libnet-ldap-perl libpdf-api2-perl libtemplate-perl libtext-csv-xs-perl libxml-libxml-perl libxml-libxslt-perl libxml-parser-perl libyaml-libyaml-perl -y

2. Preparación de la Base de Datos

Znuny maneja grandes cantidades de datos y archivos adjuntos, por lo que MariaDB requiere ajustes específicos en su configuración para evitar errores de paquetes grandes.

Optimiza MariaDB : Edita /etc/mysql/mariadb.conf.d/50-server.cnf y añade lo siguiente bajo la sección [mysqld]:

max_allowed_packet = 64M

innodb_log_file_size = 256M

innodb_buffer_pool_size = 1G (o el 50% de tu RAM)

Reinicia el servicio: sudo systemctl restart mariadb.

Crea la base de datos:

SQL

CREATE DATABASE znuny CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'znuny_user'@'localhost' IDENTIFIED BY 'TuPasswordSegura';

GRANT ALL PRIVILEGES ON znuny.* TO 'znuny_user'@'localhost';

FLUSH PRIVILEGES;

EXIT;

3. Instalación de Znuny

Por seguridad, el sistema debe correr bajo su propio usuario y no como root.

Crear usuario de sistema: sudo useradd -d /opt/otrs -c 'Znuny user' -g www-data -s /bin/bash otrs.

Descargar y extraer:

Bash

cd /opt

sudo wget https://download.znuny.org/releases/znuny-latest.tar.gz

sudo tar -xzf znuny-latest.tar.gz

sudo mv znuny-* otrs

```

---

## 4. Configuración de Permisos y Módulos

Znuny incluye herramientas de diagnóstico que son vitales antes de iniciar el instalador web.

1. **Verificar módulos de Perl**:

```bash

sudo /opt/otrs/bin/otrs.CheckModules.pl

```

*Si falta algún módulo marcado como "Not installed", instálalo mediante `apt`*.

2. **Establecer permisos**:

```bash

cd /opt/otrs

sudo cp Kernel/Config.pm.dist Kernel/Config.pm

sudo bin/otrs.SetPermissions.pl --web-group=www-data

```

---

## 5. Configuración del Servidor Web Apache

Debes habilitar el módulo de Perl en Apache y vincular la configuración que Znuny trae por defecto.

1. **Vincular configuración**: `sudo ln -s /opt/otrs/scripts/apache2-httpd.include.conf /etc/apache2/sites-available/znuny.conf`.

2. **Activar sitio y módulos**:

```bash

sudo a2enmod perl

sudo a2enmod headers

sudo a2ensite znuny.conf

sudo systemctl restart apache2

```

---

## 6. Asistente de Instalación Web 🌐

Accede a `http://tu-ip-o-dominio/otrs/installer.pl` desde tu navegador.

* **Paso 1**: Acepta la licencia.

* **Paso 2**: Introduce las credenciales de la base de datos creadas en el Paso 2.

* **Paso 3**: Define el FQDN (ej. `tickets.tuempresa.com`) y el idioma.

* **Final**: Anota la contraseña generada para el usuario `root@localhost`.

---

## 7. Activación de Demonios (El "Corazón" del sistema) 

Znuny no procesará correos ni tareas automáticas si su demonio interno no está activo.

1. **Iniciar el Daemon**: `sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl start`.

2. **Configurar Cron**:

```bash

cd /opt/otrs/var/cron

for foo in *.dist; do sudo -u otrs cp $foo ${foo%%.dist}; done

sudo -u otrs /opt/otrs/bin/Cron.sh start

```

---

### Mantenimiento Preventivo

| Tarea | Propósito | Comando |

| :--- | :--- | :--- |

| **Limpiar Caché** | Resuelve lentitud o errores visuales. | `sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Cache::Delete` |

| **Loader** | Refresca archivos JS y CSS tras cambios. | `sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Loader::CacheCleanup` |

| **Estado** | Verifica si el motor está vivo. | `sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl status` |

Znuny es excepcionalmente estable una vez configurado, pero recuerda siempre realizar los cambios de archivos o ejecución de scripts como el usuario `otrs` para no romper los permisos del sistema.

¿Te gustaría que te explicara cómo configurar el primer buzón de correo para que Znuny empiece a convertir tus emails en tickets automáticamente?

Cómo solucionar problemas de OTRS en linux

 Le preguntamos a gemini, la inteligencia artificial de Google cómo solucionar problemas de OTRS  en linux

Explicanos detalladamente cómo solucionar problemas de OTRS en linux

Reparar OTRS (o su versión comunitaria Znuny) es un arte que requiere entender cómo interactúan Perl, Apache y el "Daemon" del sistema. A diferencia de otros sistemas, OTRS es extremadamente sensible a los cambios de usuario; si ejecutas un comando como root en lugar del usuario otrs, puedes romper los permisos de todo el sistema de archivos en un segundo.

Aquí tienes la guía de "mecánica avanzada" para diagnosticar y solucionar fallos en OTRS/Znuny.

1. El "Panel de Control": El Comando Console.pl

Casi todos los problemas de OTRS se resuelven o se diagnostican usando la herramienta de consola. Regla de oro: Ejecútala siempre como el usuario otrs.

Bash

# Entrar como usuario otrs

sudo -u otrs /opt/otrs/bin/otrs.Console.pl

Si ejecutas este comando sin parámetros, verás una lista masiva de herramientas de reparación. Las más importantes para solucionar problemas son las de la familia Maint::.

2. El "Corazón" detenido: El OTRS Daemon

Si los tickets no llegan, las notificaciones no salen o las tareas programadas no se ejecutan, el Daemon se ha detenido. Es el motor que procesa todo en segundo plano.

Diagnóstico:

Bash

sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl status

Solución:

Si no está corriendo, inícialo. Si está "atascado", reinícialo:

Bash

sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl stop

sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl start

3. Problemas de Interfaz (CSS/JS roto o lento)

¿Has instalado un paquete o editado un archivo y la web se ve "rota" o no cargan los menús? OTRS usa un sistema llamado Loader que cachea archivos estáticos.

La solución de limpieza total:

Bash

# Borrar la caché del sistema

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Cache::Delete

# Borrar la caché del cargador de archivos (JS/CSS)

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Loader::CacheCleanup

4. El Infierno de los Permisos

Es el error más común tras una migración o una actualización. Si el servidor web no puede escribir en var/ o Kernel/, OTRS morirá con un error "500".

Cómo arreglarlo de una vez por todas:

Usa el script oficial de OTRS para restablecer los permisos correctos:

Bash

cd /opt/otrs

sudo bin/otrs.SetPermissions.pl --web-group=www-data

5. Fallos en el Envío/Recepción de Correos

Si el Daemon está corriendo pero los correos no entran, el problema suele estar en la comunicación con el servidor IMAP/SMTP o en un ticket "pesado" que bloquea la cola.

Verificar errores de comunicación:

Bash

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Email::MailQueue --list

Forzar el envío de la cola:

Bash

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Email::MailQueue --send

Ver los logs en tiempo real:

No mires solo el log de OTRS; mira el log del sistema para errores de Perl:

Bash

tail -f /opt/otrs/var/log/otrs.log

journalctl -u apache2 -f

6. Comprobación de Módulos de Perl

A veces, una actualización del sistema operativo (apt upgrade) actualiza Perl pero deja huérfanas algunas librerías que OTRS necesita.

Comando de verificación:

Bash

sudo /opt/otrs/bin/otrs.CheckModules.pl

Si ves algún módulo marcado como "Not installed" que sea crítico (como DBI o XML::Parser), instálalo de inmediato usando apt o cpan.

Tabla de Rescate Rápido

Síntoma	Causa Probable	Comando de Rescate
Error 500 al entrar a la web	Permisos incorrectos o Apache mal configurado.	otrs.SetPermissions.pl
Cambios en Config.pm no se ven	Caché de configuración activa.	otrs.Console.pl Maint::Config::Rebuild
Tickets no se indexan/buscan	Índice de búsqueda corrupto.	otrs.Console.pl Maint::Search::Zebra::Rebuild
Base de datos lenta	Tablas necesitan optimización.	otrs.Console.pl Maint::Database::Check

Un toque de "candor" técnico

OTRS es como un reloj suizo de los años 80: es increíblemente preciso pero si le entra una mota de polvo (un error de sintaxis en el archivo Config.pm), se detiene por completo. 

Consejo de amigo: Antes de editar cualquier archivo en /opt/otrs/Kernel/, haz una copia de seguridad (.bak). Un solo punto y coma ; olvidado en Perl puede tumbar todo tu Help Desk.

¿Te ha salido algún error específico sobre "Can't create PID file" o es más un problema de que la base de datos está alcanzando el límite de conexiones?

Expert Guide: Solo si necesitas algo muy puntual, puedo darte el comando exacto para debugear una tabla específica de la base de datos.

Cómo instalar y configurar OTRS en linux

 Le pedimos a Gemini, la inteligencia artificial de Google nos explique cómo instalar y configurar OTRS  en linux

Explicanos detalladamente cómo instalar y configurar OTRS en linux

Instalar OTRS ( Open Ticket Request System ) —o su versión comunitaria actual, Znuny —  es entrar en las ligas mayores de la gestión de servicios ( ITSM ). A diferencia de otros sistemas que hemos visto, OTRS no corre sobre el típico PHP; su motor es Perl. Esto lo hace extremadamente potente y modular, pero también requiere una configuración de servidor un poco más "exótica".

En 2026, la mayoría de la comunidad se ha movido a Znuny (el fork de código abierto), ya que OTRS AG dejó de dar soporte a la versión gratuita. Aquí tienes la guía definitiva para instalarlo en Ubuntu 24.04/22.04.

1. El Ecosistema: Stack LAMP + Perl

OTRS/Znuny necesita un servidor web (Apache), una base de datos (MariaDB) y una gran cantidad de módulos de Perl para procesar la lógica de negocio.

Instalación de dependencias:

Bash

sudo apt update

sudo apt install apache2 mariadb-server libapache2-mod-perl2 git -y

# Módulos de Perl necesarios (son bastantes)

sudo apt install libapache-dbi-perl libarchive-zip-perl libauthen-ntlm-perl libcgi-pm-perl libcrypt-openssl-rsa-perl libcrypt-ssleay-perl libdbd-mysql-perl libencode-hanextra-perl libgd-gd2-perl libgd-graph-perl libgd-text-perl libio-socket-ssl-perl libjson-xs-perl libmail-imapclient-perl libnet-dns-perl libnet-ldap-perl libpdf-api2-perl libtemplate-perl libtext-csv-xs-perl libxml-libxml-perl libxml-libxslt-perl libxml-parser-perl libyaml-libyaml-perl -y

2. Preparación de la Base de Datos

OTRS es "hambriento" de recursos de base de datos. Necesitamos ajustar MariaDB para que acepte paquetes grandes, algo vital para los archivos adjuntos en los tickets.

Configura MariaDB : Edita /etc/mysql/mariadb.conf.d/50-server.cnf y añade/ajusta esto bajo

[mysqld]:

Ini, TOML

max_allowed_packet = 64M

innodb_log_file_size = 256M

innodb_buffer_pool_size = 1G # O el 50% de tu RAM

Reinicia MariaDB: sudo systemctl restart mariadb

Crea el entorno:

SQL

CREATE DATABASE znuny CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'znuny_user'@'localhost' IDENTIFIED BY 'TuPasswordSegura';

GRANT ALL PRIVILEGES ON znuny.* TO 'znuny_user'@'localhost';

FLUSH PRIVILEGES;

EXIT;

3. Instalación de Znuny/OTRS

Vamos a crear un usuario de sistema dedicado para que el software no corra como root.

Crear usuario:

Bash

sudo useradd -d /opt/otrs -c 'OTRS user' -g www-data -s /bin/bash otrs

Descargar el software:

Bash

cd /opt

sudo wget https://download.znuny.org/releases/znuny-latest.tar.gz

sudo tar -xzf znuny-latest.tar.gz

sudo mv znuny-* otrs

4. Configuración del Sistema y Permisos

OTRS incluye un script que verifica si te falta algún módulo de Perl. Es tu mejor amigo.

Verificar módulos:

Bash

sudo /opt/otrs/bin/otrs.CheckModules.pl

Si alguno aparece como "Not installed", instálalo antes de seguir.

Configurar permisos:

Bash

cd /opt/otrs

sudo cp Kernel/Config.pm.dist Kernel/Config.pm

sudo bin/otrs.SetPermissions.pl --web-group=www-data

5. Configuración de Apache

Necesitamos decirle a Apache cómo manejar los scripts .pl de OTRS.

Enlaza el archivo de configuración:

Bash

sudo ln -s /opt/otrs/scripts/apache2-httpd.include.conf /etc/apache2/sites-available/otrs.conf

Habilita los módulos y el sitio:

Bash

sudo a2enmod perl

sudo a2enmod headers

sudo a2ensite otrs.conf

sudo systemctl restart apache2

6. El Asistente Web Final 

Abre tu navegador en http://tu-ip/otrs/installer.pl.

Aceptar Licencia: (GPL).

Base de Datos: Selecciona MySQL/MariaDB y usa los datos del Paso 2.

Configuración del Sistema: Define el FQDN (ej. soporte.tuempresa.com) y el idioma.

Cuentas de Correo: Puedes saltar esto y configurarlo después dentro del panel.

Finalización: El instalador te dará la contraseña del usuario root@localhost. ¡Guárdala bien!

7. Activación de Demonios y Cron 

OTRS no funciona sin su "corazón" latiendo en segundo plano.

Iniciar el Demonio de OTRS:

Bash

sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl start

Configurar tareas Cron:

Bash

cd /opt/otrs/var/cron

for foo in *.dist; do sudo -u otrs cp $foo ${foo%%.dist}; done

sudo -u otrs /opt/otrs/bin/Cron.sh start

Tabla de Mantenimiento Crítico

Componente	Función	Cómo reiniciar/revisar
Daemon.pl	Procesa colas, correos y eventos.	sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl status
Maint::Cache	Limpia la caché del sistema.	sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Cache::Delete
Loader	Refresca archivos JS y CSS.	sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Loader::CacheCleanup

Un toque de "candor" técnico

Instalar OTRS es como montar un motor de combustión: hay muchas piezas móviles. Si la interfaz se siente lenta, es casi seguro que el OTRS Daemon no está corriendo o que no has configurado correctamente el opcache de Perl. No te asustes si al principio ves muchos menús; OTRS está diseñado para que lo configures una vez y te olvides por años.

¿Te gustaría que profundizáramos en cómo configurar los "SLA" (Acuerdos de Nivel de Servicio) para que el sistema te avise automáticamente cuando un ticket lleva demasiado tiempo sin respuesta?

Expert Guide: ¿Cuál de estas áreas te interesa configurar primero?

Cómo solucionar problemas de osticket en linux

 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 linux

Aunque 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

Síntoma	Posible Causa	Acción Recomendada
Error 500 al subir archivos	Límite de PHP excedido	Aumenta upload_max_filesize en php.ini.
Emails llegan duplicados	Doble ejecución de Cron	Revisa que no tengas el Cron de Linux y el Autocron activos a la vez.
Caracteres extraños (UTF-8)	Cotejamiento de DB incorrecto	Cambia el Collation de las tablas a utf8mb4_general_ci.
Lentitud extrema	Caché APCu desactivada	Instala php-apcu para acelerar la carga de plantillas.

Un consejo de "amigo" técnico:

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?