Cómo solucionar problemas de FreeScout en linux

Le preguntamos a Gemini, la inteligencia artificial de Google que nos expĺique cómo solucionar problemas de FreeScout en linux

Explicanos detalladamente cómo solucionar problemas de FreeScout en linux

Solucionar problemas en FreeScout suele ser un ejercicio de "detective de Laravel". Al ser un software basado en este framework de PHP, la mayoría de los fallos no son del código en sí, sino de la orquestación entre el servidor web, los permisos de archivos y, sobre todo, el Cron Job.

Aquí tienes la guía técnica para devolverle la vida a tu bandeja de entrada compartida.

1. El "Libro de la Verdad": Los Logs de Laravel

En FreeScout, los logs de Nginx o Apache solo te dirán que hubo un "Error 500", pero no por qué. El verdadero detalle está en el log interno de la aplicación.

Ruta del log: /var/www/freescout/storage/logs/laravel.log

Cómo leerlo en tiempo real:

Bash

tail -f /var/www/freescout/storage/logs/laravel.log

Si ves errores de "Permission denied" o "Connection refused", ya tienes por dónde empezar.

2. El Problema #1: Los correos no llegan ni salen

Si FreeScout parece "congelado" (no descarga correos nuevos ni envía respuestas), el 99% de las veces es culpa del Cron Job o de la Queue (cola de trabajos).

Verifica el Cron:

Ejecuta el comando manualmente para ver si lanza algún error:

Bash

sudo -u www-data php /var/www/freescout/artisan schedule:run

Estado de los procesos de fondo:

FreeScout usa tareas en segundo plano. Si el comando anterior te dice que no hay tareas programadas, revisa que tu crontab tenga la línea correcta: * * * * * php /var/www/freescout/artisan schedule:run >> /dev/null 2>&1

3. Errores de Permisos (Pantalla Blanca o Error 500)

Si tras una actualización o migración el sitio no carga, Laravel suele quejarse porque no puede escribir en sus carpetas temporales.

Aplica la "receta de permisos" estándar:

Bash

sudo chown -R www-data:www-data /var/www/freescout

sudo find /var/www/freescout -type d -exec chmod 755 {} \;

sudo find /var/www/freescout -type f -exec chmod 644 {} \;

# Carpetas que NECESITAN escritura obligatoria

sudo chmod -R 775 /var/www/freescout/storage

sudo chmod -R 775 /var/www/freescout/bootstrap/cache

sudo chmod -R 775 /var/www/freescout/public/uploads

4. Problemas de Conexión IMAP/SMTP

Si al configurar una cuenta de correo recibes un error de "Connection Timeout" o "Authentication Failed":

Puertos bloqueados: Asegúrate de que tu firewall permite tráfico saliente en los puertos 993 (IMAP) y 465/587 (SMTP).

OpenSSL: FreeScout requiere que PHP tenga habilitada la extensión php-openssl.

App Passwords: Si usas Gmail o Outlook, recuerda que no puedes usar tu contraseña normal; debes generar una "Contraseña de Aplicación" desde la configuración de seguridad de tu cuenta de correo.

5. Limpieza de Caché (El "reinicio" de software)

A veces, tras cambiar la configuración en el archivo .env, FreeScout sigue usando la configuración vieja porque Laravel la tiene cacheada.

Ejecuta estos comandos en la raíz de FreeScout para limpiar todo:

Bash

sudo -u www-data php artisan cache:clear

sudo -u www-data php artisan view:clear

sudo -u www-data php artisan config:clear

6. Error "App Key Not Found"

Si ves este error, significa que el sistema no puede cifrar/descifrar los datos (como las contraseñas de tus cuentas de correo).

Solución: Verifica que en tu archivo .env la variable APP_KEY tenga un valor. Si está vacía, genérala con:

Bash

php artisan key:generate

[!CAUTION]

No cambies la APP_KEY si ya tienes datos en el sistema, o perderás el acceso a las contraseñas guardadas (se volverán ilegibles).

Tabla de Diagnóstico Rápido

Síntoma	Causa probable	Solución rápida
Error 504 Gateway Timeout	El proceso PHP tarda demasiado.	Aumenta max_execution_time en php.ini.
Los adjuntos no se suben	Límite de tamaño de archivo.	Ajusta client_max_body_size en Nginx y upload_max_filesize en PHP.
No se guardan los ajustes	Carpeta /storage protegida.	Aplica los comandos de chmod del punto 3.
Módulos no aparecen	Carpeta /Modules sin permisos.	chown -R www-data en la carpeta Modules.

Un toque de "witty" consejo

Si nada de esto funciona, recuerda que FreeScout tiene una herramienta de "System Check" dentro del panel de administración (Manage -> System -> Tools). Es como el escáner médico del sistema: te dirá en rojo qué extensión de PHP falta o qué carpeta está bloqueada. ¡Es tu mejor amigo antes de entrar en pánico!

¿Estás teniendo problemas con un proveedor de correo específico (como una cuenta de Gmail que se desconecta sola) o el fallo es general de la interfaz?

Cómo instalar y configurar FreeScout en linux

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

Explicanos detalladamente cómo instalar y configurar FreeScout en linux

FreeScout es, posiblemente, el secreto mejor guardado de la comunidad open source para quienes buscan un sistema de tickets elegante. Es un clon casi exacto de Help Scout, pero desarrollado en PHP (Laravel), lo que lo hace ligero, rápido y extremadamente fácil de usar para el equipo de soporte.

A diferencia de Zammad o GLPI, FreeScout se centra en la bandeja de entrada compartida. Aquí tienes cómo desplegarlo en un servidor Linux (usaremos Ubuntu 24.04/22.04 como referencia).

1. Requisitos del Sistema (LEMP Stack)

FreeScout corre mejor sobre Nginx y PHP 8.1/8.2. No es muy exigente con la RAM (1GB es suficiente para equipos pequeños), pero agradece un buen procesador.

Instalación de dependencias:

Bash

sudo apt update

sudo apt install nginx mariadb-server git unzip curl -y

# Instalación de PHP y los módulos específicos que requiere Laravel/FreeScout

sudo apt install php-fpm php-mysql php-common php-phpdbg php-gd php-imap php-intl php-curl php-zip php-mbstring php-xml php-bcmath -y

2. Preparación de la Base de Datos

FreeScout necesita una base de datos para almacenar las conversaciones y configuraciones.

Entra a MariaDB: sudo mysql -u root

Configura el entorno:

SQL

CREATE DATABASE freescout CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

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

GRANT ALL PRIVILEGES ON freescout.* TO 'freescout_user'@'localhost';

FLUSH PRIVILEGES;

EXIT;

3. Instalación de FreeScout

A diferencia de otros scripts, instalaremos FreeScout directamente desde su repositorio oficial de GitHub para facilitar futuras actualizaciones.

Moverse al directorio web:

Bash

cd /var/www

sudo git clone https://github.com/freescout-helpdesk/freescout.git

sudo chown -R www-data:www-data /var/www/freescout

Configurar permisos (Crucial):

FreeScout necesita escribir en varias carpetas para funcionar correctamente.

Bash

sudo find /var/www/freescout -type d -exec chmod 755 {} \;

sudo find /var/www/freescout -type f -exec chmod 644 {} \;

sudo chmod -R 775 /var/www/freescout/storage

sudo chmod -R 775 /var/www/freescout/bootstrap/cache

sudo chmod -R 775 /var/www/freescout/public/uploads

4. Configuración de Nginx

Laravel requiere una configuración de servidor específica para manejar las rutas.

Crea el archivo: sudo nano /etc/nginx/sites-available/freescout

Pega este bloque de configuración:

Nginx

server {

listen 80;

server_name soporte.tudominio.com;

root /var/www/freescout/public;



index index.php index.html index.htm;



location / {

try_files $uri $uri/ /index.php?$query_string;

}



location ~ \.php$ {

include snippets/fastcgi-php.conf;

fastcgi_pass unix:/run/php/php8.2-fpm.sock; # Ajusta según tu versión de PHP

}



location ~ /\.ht {

deny all;

}

}

Activa el sitio y reinicia:

Bash

sudo ln -s /etc/nginx/sites-available/freescout /etc/nginx/sites-enabled/

sudo nginx -t

sudo systemctl restart nginx

5. Tarea Programada (Cron Job) - El Corazón del Sistema 

Si no configuras el Cron, FreeScout no enviará ni recibirá correos. Es el error más común.

Edita el crontab del usuario web:

Bash

sudo crontab -u www-data -e

Añade esta línea al final:

Bash

* * * * * /usr/bin/php /var/www/freescout/artisan schedule:run >> /dev/null 2>&1

6. Instalador Web Final

Ahora, abre tu navegador en http://soporte.tudominio.com. El instalador de FreeScout te guiará:

Requirements Check: Verificará que todos los módulos de PHP estén instalados.

Permissions: Confirmará que las carpetas tienen permisos de escritura.

App Setup: Introduce la URL de tu sitio.

DB Setup: Usa los datos del Paso 2 (freescout_user, TuPasswordSegura, freescout).

Acción	Por qué es importante
HTTPS (Certbot)	FreeScout maneja datos sensibles de clientes. Usa sudo certbot --nginx.
App Key	Si el instalador no la genera, ejecuta php artisan key:generate en la carpeta raíz.
Módulos Gratuitos	Revisa la sección de "Modules" en el panel. Muchos son gratuitos y añaden funciones como "Notas Internas".
Logs de App	Si algo falla, mira en /var/www/freescout/storage/logs/laravel.log.

Un detalle de "colega" técnico:

FreeScout es genial porque no requiere que tus clientes aprendan a usar un portal de tickets. Ellos simplemente envían un correo a soporte@tudominio.com, y a ti te aparece en una interfaz limpia donde puedes asignar la conversación, poner etiquetas o discutirlo internamente con tu equipo antes de responder.

¿Te gustaría que te explicara cómo configurar el "Inbound Email" usando Gmail o Outlook para que FreeScout empiece a descargar tus correos automáticamente? Solo dime qué proveedor usas.

Cómo solucionar problemas de GLPI en linux

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

Explicanos detalladamente cómo solucionar problemas de GLPI en linux

Cuando el "cerebro" de tu inventario tecnológico empieza a fallar, la presión aumenta porque dependes de él para resolver los problemas de todos los demás. GLPI es robusto, pero al ser tan modular y depender de tantas extensiones de PHP, un pequeño desajuste en el servidor puede detenerlo.

Aquí tienes la guía técnica para diagnosticar y reparar GLPI como un profesional.

1. La "Caja Negra": Los Logs de GLPI

A diferencia de otras apps, GLPI tiene sus propios registros internos que son mucho más descriptivos que los de Apache. Antes de tocar nada, mira aquí:

Ruta de logs: /var/www/html/glpi/files/_log/

php-errors.log: Aquí verás por qué una página sale en blanco o por qué un plugin no carga.

sql-errors.log: Si el error es de base de datos (tablas corruptas o fallos de actualización), aquí estará la consulta SQL exacta que falló.

cron.log: Si las tareas automáticas no se ejecutan, este archivo te dirá por qué.

[!TIP]

Comando de monitoreo en vivo: > tail -f /var/www/html/glpi/files/_log/*.log (Esto te mostrará cualquier error en tiempo real mientras navegas por la web).

2. El Problema de los Permisos (El "Top 1" de fallos)

GLPI necesita escribir constantemente en las carpetas files, config y marketplace. Si tras una actualización o migración nada funciona, casi siempre es un tema de permisos.

La solución definitiva:

Asegúrate de que el usuario del servidor web (www-data) sea el dueño de todo:

Bash

sudo chown -R www-data:www-data /var/www/html/glpi

sudo find /var/www/html/glpi -type d -exec chmod 755 {} \;

sudo find /var/www/html/glpi -type f -exec chmod 644 {} \;

3. Errores de PHP y Extensiones Faltantes

GLPI 10 es muy exigente. Si ves un error 500 Internal Server Error, lo más probable es que falte un módulo de PHP que GLPI considera "vital".

Verifica los módulos instalados: php -m

Módulos que suelen faltar en instalaciones nuevas:

php-intl (Para traducciones y fechas).

php-gd (Para generar gráficos y procesar imágenes).

php-bz2 o php-zip (Para manejar plugins y actualizaciones).

php-apcu (Para la caché, vital para la velocidad).

Si falta uno, instálalo y reinicia:

Bash

sudo apt install php-intl php-apcu

sudo systemctl restart apache2

4. Fallos en las Tareas Automáticas (Acciones Automáticas)

¿Tus tickets por correo no llegan? ¿El inventario no se actualiza? Probablemente el sistema interno de "Acciones Automáticas" se quedó atascado o no está configurado en modo CLI.

Ve a Configuración > Acciones Automáticas.

Si ves muchas tareas en estado "Programado" pero con fecha pasada, cámbialas de GLPI a CLI.

Asegúrate de que tu crontab esté funcionando:

Bash

sudo crontab -u www-data -l

# Deberías ver: * * * * * /usr/bin/php /var/www/html/glpi/front/cron.php

5. El "Modo de Depuración" (Debug Mode)

Si la interfaz web carga pero no puedes ver el error real, activa el Modo Debug. Esto te mostrará advertencias detalladas y tiempos de ejecución.

Haz clic en tu perfil (arriba a la derecha) > Modo de depuración.

Si no puedes entrar a la interfaz, puedes forzarlo en la base de datos (solo para expertos):

UPDATE glpi_users SET use_mode = 2 WHERE name = 'tu_usuario';

6. Problemas comunes tras una actualización

Síntoma	Causa	Solución
Página de actualización constante	No se borró la carpeta install.	sudo rm -rf /var/www/html/glpi/install
Error de "Cifrado de Base de Datos"	Falta el archivo glpi.key.	Restaura el archivo /etc/glpi/glpi.key de tu backup.
Plugins incompatibles	Versión antigua de un plugin.	Desactiva plugins moviendo su carpeta fuera de marketplace/.

7. Verificación del Sistema (Herramienta Interna)

GLPI tiene una página de "salud" que pocos usan pero es oro puro. Ve a:

Administración > Configuración > Sistema

Aquí GLPI te dirá exactamente:

Si tu base de datos tiene el formato de tiempo (Timezone) correcto.

Si la seguridad de las carpetas es la adecuada.

Si el límite de memoria de PHP es suficiente (recomendado 512M).

Un toque de "sabiduría de trinchera"

Si GLPI se siente lento, el culpable suele ser la base de datos MariaDB. Revisa el archivo /etc/mysql/mariadb.conf.d/50-server.cnf y asegúrate de que el valor innodb_buffer_pool_size sea al menos el 50% de tu RAM disponible. GLPI hace muchísimas lecturas pequeñas, y tener la base de datos en RAM cambia el juego por completo.

¿Te gustaría que te ayudara a crear un script de backup automático que guarde tanto la base de datos como los archivos adjuntos y los suba a un servidor externo para dormir tranquilo?