Cómo instalar y configurar UVDesk en linux

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

Explicanos detalladamente cómo instalar y configurar UVDesk en linux

UVDesk es una solución de Help Desk de código abierto extremadamente robusta, construida sobre el framework Symfony (PHP). A diferencia de otros sistemas más simples, UVDesk destaca por su arquitectura modular y su gran capacidad de personalización, lo que lo hace ideal si buscas algo profesional que se pueda escalar.

Al estar basado en Symfony, la instalación es un poco más técnica que un simple "copiar y pegar" archivos, ya que requiere el gestor de paquetes Composer.

1. Requisitos del Sistema

Para que UVDesk rinda bien en Linux (Ubuntu 22.04 o 24.04), necesitaremos un stack LAMP moderno:

PHP: 8.1 o superior (con extensiones específicas).

Servidor Web: Apache con mod_rewrite habilitado.

Base de Datos: MySQL 5.7+ o MariaDB 10.2+.

Composer: Gestor de dependencias de PHP.

2. Paso 1: Instalación del Stack y Extensiones

Primero, preparamos el servidor con PHP y una extensión crítica para UVDesk: Mailparse.

Bash

sudo apt update && sudo apt upgrade -y

sudo apt install apache2 mariadb-server php libapache2-mod-php php-mysql php-common php-gd php-phpdbg php-imap php-intl php-curl php-zip php-mbstring php-xml php-bcmath -y



# Instalación de Mailparse (necesario para procesar correos electrónicos)

sudo apt install php-dev php-pear -y

sudo pecl install mailparse

echo "extension=mailparse.so" | sudo tee /etc/php/8.x/mods-available/mailparse.ini

sudo phpenmod mailparse

3. Paso 2: Configuración de la Base de Datos

Entramos en MariaDB para crear el espacio donde UVDesk guardará los tickets.

SQL

CREATE DATABASE uvdesk;

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

GRANT ALL PRIVILEGES ON uvdesk.* TO 'uvdesk_user'@'localhost';

FLUSH PRIVILEGES;

EXIT;

4. Paso 3: Instalación de Composer y UVDesk

No descargaremos un ZIP; usaremos Composer para crear el proyecto. Esto asegura que todas las librerías de Symfony estén al día.

Instalar Composer:

Bash

curl -sS https://getcomposer.org/installer | php

sudo mv composer.phar /usr/local/bin/composer

Instalar UVDesk Community Skeleton:

Bash

cd /var/www

sudo composer create-project uvdesk/community-skeleton helpdesk

5. Paso 4: Permisos y VirtualHost

Symfony requiere permisos de escritura muy específicos en las carpetas de caché y logs.

Bash

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

sudo chmod -R 755 /var/www/helpdesk

Ahora, configuramos Apache para que apunte a la carpeta public de UVDesk:

Crear archivo: sudo nano /etc/apache2/sites-available/uvdesk.conf

Configuración:

Apache

<VirtualHost *:80>

       ServerName soporte.tudominio.com

       DocumentRoot /var/www/helpdesk/public



       <Directory /var/www/helpdesk/public>
    
              Options FollowSymLinks

              AllowOverride All

              Require all granted

        </Directory>



         ErrorLog ${APACHE_LOG_DIR}/uvdesk_error.log

         CustomLog ${APACHE_LOG_DIR}/uvdesk_access.log combined

</VirtualHost>

Activar:

Bash

sudo a2ensite uvdesk.conf

sudo a2enmod rewrite

sudo systemctl restart apache2

6. Paso 5: El Asistente de Instalación Web

Abre tu navegador en http://soporte.tudominio.com. UVDesk te recibirá con un asistente visual:

Evaluating System Requirements: Verificará que PHP y Mailparse estén listos.

Database Configuration: Introduce los datos del Paso 2.

Create Super Admin: Configura tu cuenta de acceso principal.

Install Now: El sistema ejecutará las migraciones de base de datos.

7. Configuración de Correo (Mailbox) 

UVDesk es famoso por su capacidad de convertir correos en tickets. Para configurarlo:

Ve al panel de administración > Settings > Swift Mailer.

Configura tu servidor SMTP (Gmail, Outlook o propio).

Luego ve a Mailbox y vincula esa configuración para que el sistema "escuche" los correos entrantes.

Resumen de Mantenimiento

Tarea	Comando / Ruta
Limpiar Caché	php bin/console c:c (dentro de la carpeta del proyecto)
Logs de errores	/var/www/helpdesk/var/log/
Configuración de variables	Archivo .env en la raíz del proyecto

Un detalle técnico importante

UVDesk, al ser Symfony, es muy estricto con la configuración de la base de datos en el archivo .env. Si después de la instalación cambias la contraseña de la base de datos, recuerda actualizar la línea DATABASE_URL en ese archivo, de lo contrario, verás un error de "Doctrine" inmediatamente.

¿Te gustaría que te explicara cómo automatizar la entrada de tickets mediante la configuración de un "Email Piping" para que los correos se procesen al instante sin esperar al cron?

Configurar Email Piping

Personalizar plantillas de tickets

Instalación de SSL con Certbot

Gestión de workflows y flujos de trabajo

¿Cuál de estos puntos te interesa más?