Installazione · 6 min read · Dec 21, 2025
Come installare Helpy Customer Helpdesk su Ubuntu 20.04
Helpy è un’applicazione di supporto clienti helpdesk gratuita, open-source e moderna che offre ai tuoi clienti un’esperienza eroica. È scritta in Ruby on Rails e può essere facilmente integrata con la tua applicazione e le email in entrata tramite Sendgrid, Mandrill, Mailgun, ecc. Per impostazione predefinita, Helpy funziona su tutti i dispositivi out of the box, quindi puoi deliziare i clienti con risposte tempestive, da qualsiasi luogo e in qualsiasi momento! Ha un’opzione di ricerca avanzata che ti aiuta a filtrare e trovare ticket o clienti quando hai migliaia di richieste.
In questo post, ti mostreremo come installare Helpy Helpdesk su Ubuntu 20.04.
Prerequisiti
- Un server che esegue Ubuntu 20.04.
- Una password di root configurata sul server.
Iniziare
Prima di iniziare, si consiglia di aggiornare tutti i pacchetti di sistema alla versione aggiornata. Puoi farlo eseguendo il seguente comando:
apt-get update -yUna volta aggiornati i pacchetti di sistema, installa le altre dipendenze necessarie utilizzando il seguente comando:
apt-get install apt-transport-https ca-certificates curl software-properties-commonDopo aver installato tutti i pacchetti, puoi procedere al passaggio successivo.
Installa Docker CE e Docker Compose
Installeremo Helpy nel contenitore Docker. Quindi, Docker e Docker Compose devono essere installati sul tuo server. Prima, aggiungi il repository Docker CE 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 il database del repository e installa Docker CE con il seguente comando:
apt-get update -y
apt-get install docker-ce docker-ce-cli containerd.io -yUna volta installato Docker CE, avvia e abilita il servizio Docker CE utilizzando il seguente comando:
systemctl start docker
systemctl enable dockerSuccessivamente, controlla lo stato di Docker CE con il seguente comando:
systemctl status dockerOtterrai il seguente output:
? 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="Il tuo kernel non supporta CPU realtime >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.107957338Z" level=warning msg="Il tuo kernel non supporta cgroup blkio >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.108078251Z" level=warning msg="Il tuo kernel non supporta cgroup blkio >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.108501788Z" level=info msg="Caricamento dei contenitori: avvio."
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.257733781Z" level=info msg="Il bridge predefinito (docker0) è assegnato con un >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.354919857Z" level=info msg="Caricamento dei contenitori: completato."
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.382579537Z" level=info msg="Il demone Docker" commit=459d0df graphdriver(s)=>
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.383119787Z" level=info msg="Il demone ha completato l'inizializzazione"
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"
Successivamente, scarica l’ultima versione di Docker Compose utilizzando il seguente 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 -Successivamente, imposta i permessi di esecuzione per il binario di Docker Compose con il seguente comando:
chmod +x docker-compose-linux-x86_64Successivamente, sposta il binario di Docker Compose nel percorso di sistema con il seguente comando:
mv docker-compose-linux-x86_64 /usr/local/bin/docker-composeSuccessivamente, verifica la versione di Docker Compose con il seguente comando:
docker-compose versionOtterrai il seguente output:
Docker Compose version v2.2.3
Installa Helpy
Successivamente, scarica l’ultima versione di Helpy con il seguente comando:
git clone https://github.com/helpyio/helpy.gitUna volta completato il download, cambia la directory in helpy e rinomina il file di ambiente:
cd helpy
cp docker/.env.sample docker/.envSuccessivamente, modifica il Caddyfile e definisci il tuo indirizzo IP del server:
nano docker/CaddyfileDefinisci il tuo IP del server come mostrato di seguito:
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
}
Salva e chiudi il file, quindi costruisci il contenitore Helpy con il seguente comando:
docker-compose buildDovresti vedere il seguente output:
---> 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 them
Successivamente, avvia il contenitore Helpy con il seguente comando:
docker-compose up -dDovresti vedere il seguente output:
[+] 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.3s
Successivamente, verifica tutti i contenitori in esecuzione utilizzando il seguente comando:
docker psDovresti vedere il seguente output:
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 nginx
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 seguente schermata:
Clicca su Impostiamo il tuo Helpy. Dovresti vedere la schermata di creazione dell’account amministratore:
Fornisci il tuo nome utente admin, password, indirizzo email e clicca sul pulsante Salva modifiche. Dovresti vedere la schermata Personalizza il tuo helpdesk:
Personalizza il tuo Helpdesk secondo le tue esigenze, altrimenti clicca sul pulsante Salta per ora. Dovresti vedere la schermata di configurazione del server SMTP:
Fornisci le informazioni del tuo server SMTP o clicca sul pulsante Salta per ora. Dovresti vedere la seguente schermata:
Clicca sul pulsante Inizia!. Dovresti vedere il dashboard di Helpy nella seguente schermata:
Conclusione
Congratulazioni! hai installato con successo il sistema Helpy Customer Helpdesk su Ubuntu 20.04. Ora puoi implementare Helpy nella tua organizzazione e iniziare a gestire i tuoi clienti. Sentiti libero di chiedermi se hai domande.
Ricevi i nuovi post nella tua casella di posta.
Nessuno spam. Disiscriviti in qualsiasi momento.