Come installare Helpy Customer Helpdesk su Ubuntu 22.04

Helpy è una piattaforma di supporto clienti gratuita e open-source scritta nel linguaggio Ruby on Rails. È completamente open-source e personalizzabile, quindi puoi modificarla sotto la licenza MIT. Viene utilizzata per costruire un sistema di ticketing automatizzato e può essere integrata con applicazioni di terze parti. Offre un ricco set di funzionalità, alcune delle quali sono elencate di seguito:

• Supporta il ticketing multicanale.
• Ha un ampio supporto della comunità. Integrato con email in entrata tramite Sendgrid, Mandrill, Mailgun, ecc.
• È completamente multilingue e può fornire supporto in più lingue.
• Personalizzabile e conforme al GDPR.
• Ottimizzato per dispositivi mobili e funziona su tutti i dispositivi immediatamente.

Questo post ti mostrerà come installare il sistema di supporto clienti Helpy Helpdesk su Ubuntu 22.04.

Requisiti

• Un server che esegue Ubuntu 22.04.
• Una password di root configurata sul tuo server.

Aggiorna il Sistema

Prima di tutto, dovrai aggiornare e aggiornare tutti i pacchetti di sistema all’ultima versione. Puoi aggiornare tutti eseguendo il seguente comando.

apt update -y  
apt upgrade -y

Una volta aggiornati tutti i pacchetti, dovrai anche installare alcune dipendenze aggiuntive sul tuo server. Puoi installarle tutte eseguendo il seguente comando.

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

Una volta installati tutti i pacchetti, puoi procedere al passaggio successivo.

Installa Docker e Docker Compose

In questo post, installeremo Helpy utilizzando Docker e Docker Compose. Quindi entrambi i pacchetti devono essere installati sul tuo server.

Prima di tutto, aggiungi la chiave GPG di Docker e il repository utilizzando il seguente 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"

Successivamente, aggiorna la cache del repository con il seguente comando.

apt update -y

Dopo, puoi installare sia Docker che Docker Compose utilizzando il seguente comando.

apt install docker-ce docker-compose -y

Una volta installati entrambi i pacchetti con successo, avvia e abilita il servizio Docker con il seguente comando.

systemctl start docker  
systemctl enable docker

Ora, verifica la versione di Docker utilizzando il seguente comando.

docker -v

Otterrai il seguente output.

Docker version 20.10.22, build 3a2c30b

Puoi anche vedere la versione di Docker Compose con il seguente comando.

docker-compose version

Dovresti vedere il seguente output.

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

Installa Helpy su Ubuntu 22.04

Prima di tutto, scarica l’ultima versione di Helpy dal repository GitHub utilizzando il seguente comando.

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

Una volta completato il download, naviga nella directory helpy con il seguente comando.

cd helpy

Successivamente, rinomina il file di ambiente di Helpy utilizzando il seguente comando.

cp docker/.env.sample docker/.env

Successivamente, costruisci l’immagine Docker per Helpy utilizzando il seguente comando.

docker-compose build

Dovresti vedere il seguente output.

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

Puoi verificare tutte le immagini Docker con il seguente comando.

docker images

Dovresti ottenere il seguente output.

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

Successivamente, avvia il container Helpy e Nginx con il seguente comando.

docker-compose up -d

Dovresti vedere il seguente output.

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

Successivamente, verifica lo stato di tutti i container in esecuzione con il seguente comando.

docker-compose ps

Dovresti vedere tutti i container in esecuzione nel seguente output.

      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

Aspetta un po’ di tempo per avviare tutti i container.

A questo punto, Helpy è installato e in esecuzione sul tuo sistema. Puoi ora procedere al passaggio successivo.

Accedi all’interfaccia web di Helpy

Ora, apri il tuo browser web e accedi all’interfaccia web di Helpy utilizzando l’URL http://your-server-ip. Dovresti vedere la pagina di benvenuto di Helpy.

Clicca su Iniziamo a configurare il tuo Helpy. Dovresti vedere la pagina per configurare un account amministratore.

Definisci la tua email, nome completo, azienda e password, quindi clicca sul pulsante Salva modifiche. Dovresti vedere la pagina di personalizzazione di Helpy.

Clicca sul pulsante Salta per ora. Dovresti vedere la pagina di configurazione SMTP.

Clicca sul pulsante Salta per ora. Dovresti vedere la seguente pagina.

Ora, clicca sul pulsante Inizia! Dovresti vedere il dashboard di Helpy nella seguente pagina.

Clicca sul pulsante Utenti. Dovresti vedere la seguente pagina.

Clicca sul pulsante Crea Nuovo Utente. Dovresti vedere la seguente pagina.

Fornisci le informazioni del tuo utente e clicca sul pulsante Salva modifiche per creare un nuovo utente.

Puoi anche cliccare sul pulsante Report per vedere i tuoi report sui ticket nella seguente pagina.

Conclusione

Congratulazioni! hai installato con successo Helpy Customer Helpdesk su Ubuntu 22.04. Puoi ora utilizzare Helpy nella tua organizzazione per rispondere alle domande dei clienti da una posizione centrale. Sentiti libero di chiedermi se hai domande.