· Tutorial ·

Instalación de osTicket en un servidor con Linux Debian 10

En este manual te enseñaremos cómo instalar osTicket en tu servidor.

info Para la realización del manual se ha usado un servidor Debian 10 totalmente vacío (sin SWPanel). La mayor parte de la instalación se realizará a través de la consola.

Requisitos

Para poder instalar el software osTicket necesitas cumplir una serie de requisitos previos:

  • Un servidor actualizado (en nuestro caso un Debian 10)
  • Un entorno LAMP (Linux, Apache, MariaDB/MySQL y PHP)
  • Un usuario con permisos sudo (usaremos el usuario root)
  • Acceso a Internet (para descargar el software)

Preparación del servidor

Ejecutamos los siguientes comandos desde el terminal con el usuario root:

  1. Actualizamos el sistema
sudo apt update && sudo apt -y upgrade
  1. Instalamos el programa unzip
sudo apt install -y unzip
  1. Instalamos Apache
sudo apt install apache2 apache2-utils
  1. Habilitamos el inicio automático de Apache al reiniciar nuestro sistema
systemctl enable apache2
  1. Configuramos www-data (usuario de apache) como propietario de la raíz web
chown www-data:www-data /var/www/ -R
  1. Instalamos MariaDB
sudo apt install mariadb-server mariadb-client
  1. Habilitamos el inicio automático de MariaDB al reiniciar nuestro sistema
systemctl enable mariadb
  1. Instalamos PHP 7.3
apt install php7.3 libapache2-mod-php7.3 php7.3-mysql php-common php7.3-cli php7.3-common php7.3-json php7.3-opcache php7.3-readline
  1. Habilitamos el modulo Apache php 7.3
a2enmod php7.3
  1. Reiniciamos el servidor web
systemctl restart apache2

Instalación del software

Ejecutamos los siguientes comandos desde el terminal con el usuario root:

  1. Descargamos el programa desde el sitio de desarrollo
wget -q https://github.com/osTicket/osTicket/releases/download/v1.15.2/osTicket-v1.15.2.zip
  1. Descomprimimos el fichero descargado
unzip -q osTicket-v1.15.2.zip
  1. Movemos la carpeta que contiene la aplicación al directorio raíz
mv upload/ /var/www/osticket
  1. Borramos la carpeta scripts (no la vamos a utilizar)
rm -r scripts
  1. Borramos el fichero zip (ya no lo necesitamos)
rm -r osTicket-v1.15.2.zip
  1. Crearemos el archivo de configuración inicial de osTicket
cp /var/www/osticket/include/ost-sampleconfig.php /var/www/osticket/include/ost-config.php
  1. Damos permiso de escritura al fichero de configuración de la aplicación
chown www-data: /var/www/osticket/include/ost-config.php

Base de datos

Vamos a crear la base de datos para que funcione correctamente con la aplicación

  1. Conectamos con la base de datos con el usuario root y su contraseña
mysql -u root -p

(introduciremos la contraseña del usuario root y pulsaremos intro)

  1. Crearemos la Base de Datos con el nombre "osticket"
create database osticket charset utf8mb4 collate utf8mb4_unicode_ci;
  1. Crearemos el usuario y contraseña de la Base de Datos (Sustituir las X por la contraseña deseada)
create user osticket@localhost identified by 'XXXXXXXX';
  1. Daremos los permisos necesarios al usuario sobre la Base de Datos
grant all privileges on osticket.* to osticket@localhost;
  1. Cerraremos la conexión con la Base de Datos
exit

Servidor web

Vamos a configurar el servidor web para que funcione correctamente con la aplicación.

  1. Creamos una configuración para el servicio web de osticket
nano /etc/apache2/sites-available/osticket.conf
  1. El contenido del fichero será:
Alias /osticket /var/www/osticket
  1. Cerramos el archivo guardando los cambios presionando Ctrl+X y presionando y+intro.

  2. Activamos la nueva configuración

a2ensite osticket.conf
  1. Recargamos la configuración del servidor web
systemctl reload apache2

PHP

Instalamos las extensiones necesarias para que funcione correctamente la aplicación.

  1. Para la versión 7.3 (la que recomienda la aplicación)
apt install -y php7.3-apcu php7.3-gd php7.3-imap php7.3-intl php7.3-mbstring php7.3-xml
  1. Reiniciamos el servidor web para que los cambios tengan efecto
systemctl reload apache2

Instalación web

La última fase de la instalación es configurar la aplicación a través de un explorador web donde nos permitirá crear el usuario administrador y nos pedirá los datos de la base de datos.

Para poder acceder a esta configuración, abriremos un explorador web y buscaremos http://dominio/osticket o en su defecto http://nombre-de-la-maquina/osticket.

La primera página nos mostrará una serie de comprobaciones, si hemos seguido el manual, las tendremos todas correctas y haremos clic en Continue.

En la siguiente página nos dejará crear el usuario administrador, su contraseña y nos pedirá los datos de conexión de la base de datos. Una vez introducidos haremos clic en Install Now. Datos requeridos:

System Settings

  • Helpdesk Name (Ponemos el nombre de nuestra compañía)
  • Default Email (Ponemos un correo de nuestra compañía)

Admin User

  • First Name (Ponemos el nombre del usuario administrador)
  • Last Name (Ponemos el apellido del usuario administrador)
  • Email Address (Ponemos el mail del usuario administrador)
  • Username (No existe, lo creamos ahora)
  • Password (No existe, lo creamos ahora)
  • Retype Password (Volvemos a poner el pasword)

Database Settings

  • MySQL Table Prefix (lo dejamos tal y como está)
  • MySQL Hostname (lo dejamos tal y como está)
  • MySQL Database (nombre de la base de datos --> osticket)
  • MySQL Username (usuario de la base de datos -->osticket)
  • MySQL Password (la contraseña de la base de datos que pusimos -->XXXXXXXX)

El proceso de instalación tardará un momento y nos mostrará una última página donde nos informará del resultado exitoso de la operación y nos sugerirá que demos permiso al archivo de configuración de la aplicación.

  1. Borraremos el instalador web de la aplicación
rm -rf /var/www/osticket/setup/
  1. Daremos permisos al fichero de configuración
chmod 0644 /var/www/osticket/include/ost-config.php

success Listo! Ya podremos acceder a nuestro servicio de osTicket usando la URL: http://dominio/osticket

Para acceder al backend lo haremos a través de la misma URL pero añadiendo "/scp" al final (http://dominio/osticket/scp).

Modificar el idioma (opcional)

Para poder modificar el idioma de la aplicación tenemos que descargar el fichero del idioma que nos interesa desde la página oficial de la aplicación, pasar el archivo por FTP y descomprimirlo en la ubicación correcta. Como el servidor que usamos es un Debian 10 vacío, lo primero será crear un usuario e instalar el servicio de FTP.

  1. Creamos un usuario en el sistema para el FTP
adduser testftp
  • Introducimos la contraseña y presionamos intro.
  • Repetimos la contraseña y presionamos intro.
  • Hacemos 5 intros, presionamos y + intro.
  1. Instalación de vsftp desde los repositorios de Debian 10
sudo apt -y install vsftpd
  1. Configuramos el servicio de FTP modificando su fichero de configuración
nano /etc/vsftpd.conf
  1. Modificamos:
...
write_enable=YES
...
ssl_enable=YES
...
  1. Cerramos el fichero con Ctrl + x y lo guardamos con y + intro.

  2. Reiniciamos el servicio para que las modificaciones tengan efecto

systemctl reload vsftpd 
  1. Descargamos el paquete de idioma de la web oficial de [osTicket] (https://osticket.com/download/) haciendo clic en Language pack, seleccionando el idioma (Spanish - Español) y haciendo clic en Download.

  2. Pasamos por FTP el paquete de idioma al servidor con algún cliente FTP como Filezilla.

  3. Descomprimimos el paquete en el directorio correcto.

unzip /home/testftp/osTicket-lang.zip -d /var/www/osticket/include/i18n/ 
  1. Entramos en el backend con la URL http://dominio/osticket/scp

  2. Usamos las credenciales del usuario administrador para entrar.

  3. Hacemos clic en la pestaña settings

  1. Buscamos la opción Primary Language y seleccionamos "español (España)"

  2. Bajamos al final de la página y hacemos clic en Save Changes

info Listo! Si cambiamos de pestaña o salimos, ya nos modifica el idioma.

i