Helpdesk OpenSource con ZAMMAD

Zammad es un servicio de asistencia gratuito o un sistema de seguimiento de problemas. Ofrece la conexión de varios canales como correo electrónico, chat, teléfono, Twitter o Facebook. Zammad está desarrollado en los lenguajes de programación Ruby y JavaScript.

Requisitos previos

Para completar este tutorial, necesitará lo siguiente:

• Un servidor Ubuntu 20.04 con un usuario sudo. Puede configurar esto siguiendo nuestra guía de configuración inicial del servidor Ubuntu 20.04.
• Docker instalado

Requerimientos de sistema

• Memoria : 2GB o más
• Disco duro : Más de 5GB de espacio disponible en disco duro
• Sistema : CentOS 7.1+ (Ubuntu20, Debian10), garantizar que sea un sistema operativo limpio

Creacion de archivo YML

Creamos un directorio llamado docker y en ella generamos nuestro archivo yml para ingresar los comandos de instalacion de Portainer

mkdir -p docker/zammad
cd docker/zammad
touch docker-compose.yml

Editamos nuestro archivo docker-compose.yml e ingresamos los siguientes valores :

version: '3.7'

services:
  zammad:
    image: zammad/zammad
    container_name: helpdesk #cambiar por uno de preferencia
    networks:
  #    - proxy
      - default
    ports:
      - 8090:80
    restart: always
  #  labels:
  #    - "traefik.enable=true"
  #    - "traefik.docker.network=proxy"
  #    - "traefik.http.routers.helpdesk-secure.entrypoints=websecure"
  #    - "traefik.http.routers.helpdesk-secure.rule=Host(`subdomain.domain.com`)"

#networks:
#  proxy:
#    external: true

Si esta intentando montar el contenedor junto a traefik, recomendamos que se quite los comentarios y se personalice los labels para ingresar su propio dominio, si deseas probar el sistema asegurece que dichos campos esten comentados.

Luego iniciamos nuestro contendor de portainer con el siguiente comando:

docker-compose up -d

Tras unos segundos ya podrás acceder a ZAMMAD a través del navegador. Si accedes desde la misma máquina en la que tienes instalado Docker lo puedes hacer con la dirección http://localhost:8090 (o el puerto que hayas especificado). Si lo haces desde otro dispositivo la dirección sería https://zammad.mydomain.com si no cuentas con un dominio, puedes ingresar con la IP del servidor https://ip:8090

Proceso de instalación del sistema

Una vez culminado el proceso de preinstalación, debemos ingresar via web de nuestro contenedor para culminar la instalación.

Solución a errores comunes

Para resolver este problema debemos realizar lo siguiente :

1. Ingresamos a nuestra terminal y ejecutamos el siguiente comando: docker ps -a
2. Identificamos el contenedor ZAMMAD e ingresamos a la misma con el siguiente comando: docker exec -ti id- contenedor bash
3. Luego de ingresar al contenedor, editamos al archivo de configuración de NGINX con el siguiente comando: vim /etc/nginx/sites-available/default
4. Ubicamos los parametro proxy_set_header X-Forwarded-Proto y añadimos https; teniedo como resultado final lo siguiente: proxy_set_header X-Forwarded-Proto https;
5. Reiniciamos el servicio NGINX con el siguiente comando: service nginx restart
6. Validamos los cambios e ingresamos nuevamente al sistema ZAMMAD

Conclusión

En este artículo, ha aprendido a instalar ZAMMAD en docker con la distribución Ubuntu 20.04