Comment installer Helpy Customer Helpdesk sur Ubuntu 22.04

Helpy est une plateforme de support client gratuite et open-source écrite dans le langage Ruby on Rails. Elle est entièrement open-source et personnalisable, vous pouvez donc la modifier sous la licence MIT. Elle est utilisée pour construire un système de billetterie automatisé et peut être intégrée à des applications tierces. Elle offre un ensemble riche de fonctionnalités, dont certaines sont listées ci-dessous :

• Prend en charge la billetterie multicanal.
• Elle bénéficie d’un large soutien communautaire. Intégrée avec des e-mails entrants via Sendgrid, Mandrill, Mailgun, etc.
• Elle est entièrement multilingue et peut fournir un support dans plusieurs langues.
• Personnalisable et conforme au RGPD.
• Compatible mobile et fonctionne sur tous les appareils dès la sortie de la boîte.

Cet article vous montrera comment installer le système de support client Helpy Helpdesk sur Ubuntu 22.04.

Exigences

• Un serveur exécutant Ubuntu 22.04.
• Un mot de passe root configuré sur votre serveur.

Mettre à jour le système

Tout d’abord, vous devrez mettre à jour et améliorer tous les paquets système vers la dernière version. Vous pouvez les mettre à jour tous en exécutant la commande suivante.

apt update -y  
apt upgrade -y

Une fois tous les paquets mis à jour, vous devrez également installer quelques dépendances supplémentaires sur votre serveur. Vous pouvez les installer tous en exécutant la commande suivante.

apt install apt-transport-https ca-certificates curl software-properties-common git -y

Une fois tous les paquets installés, vous pouvez passer à l’étape suivante.

Installer Docker et Docker Compose

Dans cet article, nous allons installer Helpy en utilisant Docker et Docker Compose. Donc, les deux paquets doivent être installés sur votre serveur.

Tout d’abord, ajoutez la clé GPG de Docker et le dépôt 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 le cache du dépôt avec la commande suivante.

apt update -y

Ensuite, vous pouvez installer Docker et Docker Compose en utilisant la commande suivante.

apt install docker-ce docker-compose -y

Une fois les deux paquets installés avec succès, démarrez et activez le service Docker avec la commande suivante.

systemctl start docker  
systemctl enable docker

Maintenant, vérifiez la version de Docker en utilisant la commande suivante.

docker -v

Vous obtiendrez la sortie suivante.

Docker version 20.10.22, build 3a2c30b

Vous pouvez également voir la version de Docker Compose avec la commande suivante.

docker-compose version

Vous devriez voir la sortie suivante.

docker-compose version 1.29.2, build unknown
docker-py version: 5.0.3
CPython version: 3.10.4
OpenSSL version: OpenSSL 3.0.2 15 Mar 2022

Installer Helpy sur Ubuntu 22.04

Tout d’abord, téléchargez la dernière version de Helpy depuis le dépôt GitHub en utilisant la commande suivante.

git clone https://github.com/helpyio/helpy.git

Une fois le téléchargement terminé, naviguez vers le répertoire helpy avec la commande suivante.

cd helpy

Ensuite, renommez le fichier d’environnement Helpy en utilisant la commande suivante.

cp docker/.env.sample docker/.env

Ensuite, construisez l’image Docker pour Helpy en utilisant la commande suivante.

docker-compose build

Vous devriez voir la sortie suivante.

Building helpy
Sending build context to Docker daemon  134.4MB
Step 1/20 : FROM ruby:2.5
2.5: Pulling from library/ruby
0bc3020d05f1: Pull complete 
a110e5871660: Pull complete 
83d3c0fa203a: Pull complete 
a8fd09c11b02: Pull complete 
14feb89c4a52: Pull complete 
958d2475f181: Pull complete 
ba6c4f28fec1: Pull complete 
757d13b54b5e: Pull complete 
Digest: sha256:ecc3e4f5da13d881a415c9692bb52d2b85b090f38f4ad99ae94f932b3598444b
Status: Downloaded newer image for ruby:2.5
 ---> 27d049ce98db
Step 2/20 : ENV RAILS_ENV=production     HELPY_HOME=/helpy     HELPY_USER=helpyuser     HELPY_SLACK_INTEGRATION_ENABLED=true     BUNDLE_PATH=/opt/helpy-bundle

Vous pouvez vérifier toutes les images Docker avec la commande suivante.

docker images

Vous devriez obtenir la sortie suivante.

REPOSITORY    TAG       IMAGE ID       CREATED          SIZE
helpy_helpy   latest    9d59c3019f8f   32 seconds ago   1.91GB
ruby          2.5       27d049ce98db   18 months ago    843MB

Ensuite, démarrez le conteneur Helpy et Nginx avec la commande suivante.

docker-compose up -d

Vous devriez voir la sortie suivante.

Creating network "helpy_front" with driver "bridge"
Creating network "helpy_back" with driver "bridge"
Creating volume "helpy_rails-assets" with local driver
Pulling frontend (nginx:1.15)...
1.15: Pulling from library/nginx
743f2d6c1f65: Pull complete
6bfc4ec4420a: Pull complete
688a776db95f: Pull complete
Digest: sha256:23b4dcdf0d34d4a129755fc6f52e1c6e23bb34ea011b315d87e193033bcd1b68
Status: Downloaded newer image for nginx:1.15
Pulling postgres (postgres:9.4)...
9.4: Pulling from library/postgres
619014d83c02: Pull complete
7ec0fe6664f6: Pull complete
9ca7ba8f7764: Pull complete
9e1155d037e2: Pull complete
febcfb7f8870: Pull complete
8c78c79412b5: Pull complete
5a35744405c5: Pull complete
27717922e067: Pull complete
36f0c5255550: Pull complete
dbf0a396f422: Pull complete
ec4c06ea33e5: Pull complete
e8dd33eba6d1: Pull complete
51c81b3b2c20: Pull complete
2a03dd76f5d7: Pull complete
Digest: sha256:42a7a6a647a602efa9592edd1f56359800d079b93fa52c5d92244c58ac4a2ab9
Status: Downloaded newer image for postgres:9.4
Creating nginx            ... done
Creating helpy_postgres_1 ... done
Creating helpy_helpy_1    ... done

Ensuite, vérifiez l’état de tous les conteneurs en cours d’exécution avec la commande suivante.

docker-compose ps

Vous devriez voir tous les conteneurs en cours d’exécution dans la sortie suivante.

      Name                    Command               State                                   Ports                                 
----------------------------------------------------------------------------------------------------------------------------------
helpy_helpy_1      /bin/bash /helpy/docker/run.sh   Up      0.0.0.0:3000->3000/tcp,:::3000->3000/tcp                              
helpy_postgres_1   docker-entrypoint.sh postgres    Up      5432/tcp                                                               
nginx              nginx -g daemon off;             Up      0.0.0.0:443->443/tcp,:::443->443/tcp, 0.0.0.0:80->80/tcp,:::80->80/tcp

Attendez un moment pour démarrer tous les conteneurs.

À ce stade, Helpy est installé et fonctionne sur votre système. Vous pouvez maintenant passer à l’étape suivante.

Accé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 la page d’accueil de Helpy.

Cliquez sur Configurons votre Helpy. Vous devriez voir la page de configuration d’un compte administrateur.

Définissez votre e-mail, nom complet, entreprise et mot de passe, puis cliquez sur le bouton Enregistrer les modifications. Vous devriez voir la page de personnalisation de Helpy.

Cliquez sur le bouton Passer pour l’instant. Vous devriez voir la page de configuration SMTP.

Cliquez sur le bouton Passer pour l’instant. Vous devriez voir la page suivante.

Maintenant, cliquez sur le bouton Commencer ! Vous devriez voir le tableau de bord de Helpy sur la page suivante.

Cliquez sur le bouton Utilisateurs. Vous devriez voir la page suivante.

Cliquez sur le bouton Créer un nouvel utilisateur. Vous devriez voir la page suivante.

Fournissez vos informations utilisateur et cliquez sur le bouton Enregistrer les modifications pour créer un nouvel utilisateur.

Vous pouvez également cliquer sur le bouton Rapports pour voir vos rapports de tickets sur la page suivante.

Conclusion

Félicitations ! Vous avez réussi à installer Helpy Customer Helpdesk sur Ubuntu 22.04. Vous pouvez maintenant utiliser Helpy dans votre organisation pour répondre aux questions des clients depuis un emplacement central. N’hésitez pas à me poser des questions si vous en avez.