Installation · 6 min read · Dec 21, 2025
Comment installer Helpy Customer Helpdesk sur Ubuntu 20.04
Helpy est une application de support client moderne, gratuite et open-source qui offre à vos clients une expérience héroïque. Elle est écrite en Ruby on Rails et peut être facilement intégrée à votre application et à vos e-mails entrants via Sendgrid, Mandrill, Mailgun, etc. Par défaut, Helpy fonctionne sur tous les appareils dès la sortie de la boîte, vous permettant ainsi de ravir vos clients avec des réponses rapides, de n’importe où et à tout moment ! Elle dispose d’une option de recherche avancée qui vous aide à filtrer et à trouver des tickets ou des clients lorsque vous en avez des milliers.
Dans cet article, nous allons vous montrer comment installer Helpy Helpdesk sur Ubuntu 20.04.
Prérequis
- Un serveur exécutant Ubuntu 20.04.
- Un mot de passe root configuré sur le serveur.
Prise en main
Avant de commencer, il est recommandé de mettre à jour tous les paquets système vers la version mise à jour. Vous pouvez le faire en exécutant la commande suivante :
apt-get update -yUne fois que vos paquets système sont à jour, installez les autres dépendances requises en utilisant la commande suivante :
apt-get install apt-transport-https ca-certificates curl software-properties-commonAprès avoir installé tous les paquets, vous pouvez passer à l’étape suivante.
Installer Docker CE et Docker Compose
Nous allons installer Helpy dans le conteneur Docker. Donc, Docker et Docker Compose doivent être installés sur votre serveur. Tout d’abord, ajoutez le dépôt Docker CE en utilisant la commande suivante :
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"Ensuite, mettez à jour la base de données du dépôt et installez Docker CE avec la commande suivante :
apt-get update -y
apt-get install docker-ce docker-ce-cli containerd.io -yUne fois Docker CE installé, démarrez et activez le service Docker CE en utilisant la commande suivante :
systemctl start docker
systemctl enable dockerEnsuite, vérifiez l’état de Docker CE avec la commande suivante :
systemctl status dockerVous obtiendrez la sortie suivante :
? 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="Votre noyau ne prend pas en charge CPU realtime >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.107957338Z" level=warning msg="Votre noyau ne prend pas en charge cgroup blkio >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.108078251Z" level=warning msg="Votre noyau ne prend pas en charge cgroup blkio >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.108501788Z" level=info msg="Chargement des conteneurs : démarrage."
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.257733781Z" level=info msg="Le pont par défaut (docker0) est assigné avec un >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.354919857Z" level=info msg="Chargement des conteneurs : terminé."
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.382579537Z" level=info msg="Le démon Docker" commit=459d0df graphdriver(s)=>
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.383119787Z" level=info msg="Le démon a terminé l'initialisation"
Feb 28 02:01:20 ubuntu2004 systemd[1]: Démarré Docker Application Container Engine.
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.444535011Z" level=info msg="API écoute sur /run/docker.sock"Ensuite, téléchargez la dernière version de Docker Compose en utilisant la commande suivante :
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 -Ensuite, définissez les permissions d’exécution pour le binaire Docker Compose avec la commande suivante :
chmod +x docker-compose-linux-x86_64Ensuite, déplacez le binaire Docker Compose vers le chemin système avec la commande suivante :
mv docker-compose-linux-x86_64 /usr/local/bin/docker-composeEnsuite, vérifiez la version de Docker Compose avec la commande suivante :
docker-compose versionVous obtiendrez la sortie suivante :
Docker Compose version v2.2.3Installer Helpy
Ensuite, téléchargez la dernière version de Helpy avec la commande suivante :
git clone https://github.com/helpyio/helpy.gitUne fois le téléchargement terminé, changez de répertoire vers helpy et renommez le fichier d’environnement :
cd helpy
cp docker/.env.sample docker/.envEnsuite, éditez le Caddyfile et définissez l’adresse IP de votre serveur :
nano docker/CaddyfileDéfinissez l’adresse IP de votre serveur comme indiqué ci-dessous :
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
}Enregistrez et fermez le fichier, puis construisez le conteneur Helpy avec la commande suivante :
docker-compose buildVous devriez voir la sortie suivante :
---> 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 themEnsuite, démarrez le conteneur Helpy avec la commande suivante :
docker-compose up -dVous devriez voir la sortie suivante :
[+] 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.3sEnsuite, vérifiez tous les conteneurs en cours d’exécution en utilisant la commande suivante :
docker psVous devriez voir la sortie suivante :
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 nginxAccéder à l’interface Web de Helpy
Maintenant, ouvrez votre navigateur Web et accédez à l’interface Web de Helpy en utilisant l’URL http://your-server-ip. Vous devriez voir l’écran suivant :
Cliquez sur Configurons votre Helpy. Vous devriez voir l’écran de création de compte administrateur :
Fournissez votre nom d’utilisateur admin, mot de passe, adresse e-mail, puis cliquez sur le bouton Enregistrer les modifications. Vous devriez voir l’écran Personnalisez votre helpdesk :
Personnalisez votre Helpdesk selon vos besoins, sinon cliquez sur le bouton Ignorer pour le moment. Vous devriez voir l’écran de configuration du serveur SMTP :
Fournissez les informations de votre serveur SMTP ou cliquez sur le bouton Ignorer pour le moment. Vous devriez voir l’écran suivant :
Cliquez sur le bouton Commencer !. Vous devriez voir le tableau de bord Helpy sur l’écran suivant :
Conclusion
Félicitations ! Vous avez réussi à installer le système Helpy Customer Helpdesk sur Ubuntu 20.04. Vous pouvez maintenant déployer Helpy dans votre organisation et commencer à gérer vos clients. N’hésitez pas à me poser des questions si vous en avez.
Recevez de nouveaux articles dans votre boîte de réception.
Aucun spam. Désabonnez-vous à tout moment.