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 linuxFreeScout 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).
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.