Instalación · 6 min read · Dec 21, 2025
Cómo instalar Helpy Customer Helpdesk en Ubuntu 20.04
Helpy es una aplicación de soporte al cliente de helpdesk gratuita, de código abierto y moderna que brinda a sus clientes una experiencia heroica. Está escrita en Ruby on Rails y se puede integrar fácilmente con su aplicación y correo electrónico entrante a través de Sendgrid, Mandrill, Mailgun, etc. Por defecto, Helpy funciona en todos los dispositivos desde el primer momento, ¡así que puede deleitar a los clientes con respuestas rápidas, desde cualquier lugar y en cualquier momento! Tiene una opción de búsqueda avanzada que le ayuda a filtrar y encontrar tickets o clientes cuando tiene miles.
En esta publicación, le mostraremos cómo instalar Helpy Helpdesk en Ubuntu 20.04.
Requisitos previos
- Un servidor que ejecute Ubuntu 20.04.
- Una contraseña de root configurada en el servidor.
Comenzando
Antes de comenzar, se recomienda actualizar todos los paquetes del sistema a la versión actualizada. Puede hacerlo ejecutando el siguiente comando:
apt-get update -yUna vez que sus paquetes del sistema estén actualizados, instale otras dependencias requeridas usando el siguiente comando:
apt-get install apt-transport-https ca-certificates curl software-properties-commonDespués de instalar todos los paquetes, puede proceder al siguiente paso.
Instalar Docker CE y Docker Compose
Instalaremos Helpy en el contenedor de Docker. Por lo tanto, Docker y Docker Compose deben estar instalados en su servidor. Primero, agregue el repositorio de Docker CE usando el siguiente comando:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | apt-key add -
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"A continuación, actualice la base de datos del repositorio e instale Docker CE con el siguiente comando:
apt-get update -y
apt-get install docker-ce docker-ce-cli containerd.io -yUna vez que Docker CE esté instalado, inicie y habilite el servicio de Docker CE usando el siguiente comando:
systemctl start docker
systemctl enable dockerA continuación, verifique el estado de Docker CE con el siguiente comando:
systemctl status dockerObtendrá la siguiente salida:
? docker.service - Docker Application Container Engine
Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2022-02-28 02:01:20 UTC; 1min 14s ago
TriggeredBy: ? docker.socket
Docs: https://docs.docker.com
Main PID: 3092 (dockerd)
Tasks: 7
Memory: 28.2M
CGroup: /system.slice/docker.service
??3092 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.107814282Z" level=warning msg="Your kernel does not support CPU realtime >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.107957338Z" level=warning msg="Your kernel does not support cgroup blkio >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.108078251Z" level=warning msg="Your kernel does not support cgroup blkio >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.108501788Z" level=info msg="Loading containers: start."
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.257733781Z" level=info msg="Default bridge (docker0) is assigned with an >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.354919857Z" level=info msg="Loading containers: done."
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.382579537Z" level=info msg="Docker daemon" commit=459d0df graphdriver(s)=>
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.383119787Z" level=info msg="Daemon has completed initialization"
Feb 28 02:01:20 ubuntu2004 systemd[1]: Started Docker Application Container Engine.
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.444535011Z" level=info msg="API listen on /run/docker.sock"A continuación, descargue la última versión de Docker Compose usando el siguiente comando:
curl -s https://api.github.com/repos/docker/compose/releases/latest | grep browser_download_url | grep docker-compose-linux-x86_64 | cut -d '"' -f 4 | wget -qi -A continuación, establezca el permiso de ejecución para el binario de Docker Compose con el siguiente comando:
chmod +x docker-compose-linux-x86_64A continuación, mueva el binario de Docker Compose a la ruta del sistema con el siguiente comando:
mv docker-compose-linux-x86_64 /usr/local/bin/docker-composeA continuación, verifique la versión de Docker Compose con el siguiente comando:
docker-compose versionObtendrá la siguiente salida:
Docker Compose version v2.2.3Instalar Helpy
A continuación, descargue la última versión de Helpy con el siguiente comando:
git clone https://github.com/helpyio/helpy.gitUna vez que la descarga se haya completado, cambie el directorio a helpy y renombre el archivo de entorno:
cd helpy
cp docker/.env.sample docker/.envA continuación, edite el Caddyfile y defina la dirección IP de su servidor:
nano docker/CaddyfileDefina la IP de su servidor como se muestra a continuación:
your-server-ip:80 {
tls off
root /helpy/public
header /assets {
gzip
Expires "Thu, 31 Dec 2037 23:55:55 GMT"
Cache-Control public
}
header /uploads
proxy / helpy:8080/ {
except /assets
except /uploads
header_upstream Host {host}
header_upstream X-Real-IP {remote}
header_upstream X-Forwarded-Proto {scheme}
}
log stdout
}Guarde y cierre el archivo, luego construya el contenedor de Helpy con el siguiente comando:
docker-compose buildDebería ver la siguiente salida:
---> Running in a3a5fe591ac2
Removing intermediate container a3a5fe591ac2
---> 7babb0f60867
Step 13/20 : VOLUME $HELPY_HOME/public
---> Running in bfc08d37a2e1
Removing intermediate container bfc08d37a2e1
---> b4a06ac5bd7b
Step 14/20 : USER root
---> Running in a2e81c390825
Removing intermediate container a2e81c390825
---> d4275c0cd8aa
Step 15/20 : COPY . $HELPY_HOME/
---> 03684c78036c
Step 16/20 : RUN chown -R $HELPY_USER $HELPY_HOME
---> Running in 5b8d7b23cab6
Removing intermediate container 5b8d7b23cab6
---> 8406e643b688
Step 17/20 : USER $HELPY_USER
---> Running in bf9c512f2486
Removing intermediate container bf9c512f2486
---> abccf6d62cdf
Step 18/20 : COPY docker/database.yml $HELPY_HOME/config/database.yml
---> fbff2ecf5a58
Step 19/20 : EXPOSE 3000
---> Running in db600cd62ecc
Removing intermediate container db600cd62ecc
---> 8ed9fd111cd4
Step 20/20 : CMD ["/bin/bash", "/helpy/docker/run.sh"]
---> Running in 4c48d0132cd3
Removing intermediate container 4c48d0132cd3
---> ac095ecbbac6
Successfully built ac095ecbbac6
Successfully tagged helpy_helpy:latest
Use 'docker scan' to run Snyk tests against images to find vulnerabilities and learn how to fix themA continuación, inicie el contenedor de Helpy con el siguiente comando:
docker-compose up -dDebería ver la siguiente salida:
[+] Running 19/19
? postgres Pulled 16.6s
? 619014d83c02 Pull complete 8.0s
? 7ec0fe6664f6 Pull complete 8.7s
? 9ca7ba8f7764 Pull complete 8.9s
? 9e1155d037e2 Pull complete 9.2s
? febcfb7f8870 Pull complete 10.4s
? 8c78c79412b5 Pull complete 10.5s
? 5a35744405c5 Pull complete 10.6s
? 27717922e067 Pull complete 10.6s
? 36f0c5255550 Pull complete 15.2s
? dbf0a396f422 Pull complete 15.3s
? ec4c06ea33e5 Pull complete 15.4s
? e8dd33eba6d1 Pull complete 15.5s
? 51c81b3b2c20 Pull complete 15.6s
? 2a03dd76f5d7 Pull complete 15.7s
? frontend Pulled 11.3s
? 743f2d6c1f65 Pull complete 7.8s
? 6bfc4ec4420a Pull complete 10.2s
? 688a776db95f Pull complete 10.4s
[+] Running 6/6
? Network helpy_front Created 0.1s
? Network helpy_back Created 0.1s
? Volume "helpy_rails-assets" Created 0.0s
? Container helpy-postgres-1 Started 1.4s
? Container nginx Started 1.5s
? Container helpy-helpy-1 Started 3.3sA continuación, verifique todos los contenedores en ejecución usando el siguiente comando:
docker psDebería ver la siguiente salida:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
8168c6d11c75 helpy_helpy "/bin/bash /helpy/do…" 2 minutes ago Up 2 minutes 0.0.0.0:3000->3000/tcp, :::3000->3000/tcp helpy-helpy-1
265597cbcbea postgres:9.4 "docker-entrypoint.s…" 2 minutes ago Up 2 minutes 5432/tcp helpy-postgres-1
b671e0a7ba1e nginx:1.15 "nginx -g 'daemon of…" 2 minutes ago Up 2 minutes 0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp nginxAcceder a la interfaz web de Helpy
Ahora, abra su navegador web y acceda a la interfaz web de Helpy usando la URL http://your-server-ip. Debería ver la siguiente pantalla:
Haga clic en Vamos a configurar su Helpy. Debería ver la pantalla de creación de cuenta de administrador:
Proporcione su nombre de usuario de administrador, contraseña, dirección de correo electrónico y haga clic en el botón Guardar cambios. Debería ver la pantalla Personalizar su helpdesk:
Personalice su Helpdesk según sus necesidades, de lo contrario, haga clic en el botón Saltar por ahora. Debería ver la pantalla de configuración del servidor SMTP:
Proporcione la información de su servidor SMTP o haga clic en el botón Saltar por ahora. Debería ver la siguiente pantalla:
Haga clic en el botón ¡Comenzar!. Debería ver el panel de control de Helpy en la siguiente pantalla:
Conclusión
¡Felicidades! ha instalado con éxito el sistema Helpy Customer Helpdesk en Ubuntu 20.04. Ahora puede implementar Helpy en su organización y comenzar a gestionar a sus clientes. No dude en preguntarme si tiene alguna pregunta.
Recibe nuevas publicaciones en tu bandeja de entrada.
No spam. Cancela la suscripción en cualquier momento.