HowtoForge

So installierst du Helpy Customer Helpdesk auf Ubuntu 22.04

von ·

Helpy ist eine kostenlose und quelloffene Kundensupport-Plattform, die in der Sprache Ruby on Rails geschrieben wurde. Sie ist vollständig quelloffen und anpassbar, sodass du sie unter der MIT-Lizenz ändern kannst. Sie wird für den Aufbau eines automatisierten Ticketingsystems verwendet und kann mit Anwendungen von Drittanbietern integriert werden. Es bietet eine Vielzahl von Funktionen, von denen einige im Folgenden aufgeführt sind:

  • Unterstützt Multichannel-Ticketing.
  • Es hat eine große Community-Unterstützung. Integriert mit eingehenden E-Mails über Sendgrid, Mandrill, Mailgun, etc.
  • Es ist vollständig mehrsprachig und kann Support in mehreren Sprachen bieten.
  • Anpassbar und GDPR-konform.
  • Sie ist mobilfreundlich und funktioniert auf allen Geräten sofort nach dem Auspacken.

In diesem Beitrag zeige ich dir, wie du das Helpy Helpdesk Customer Support System auf Ubuntu 22.04 installierst.

Voraussetzungen

  • Ein Server, auf dem Ubuntu 22.04 läuft.
  • Ein Root-Passwort ist auf deinem Server eingerichtet.

Aktualisiere das System

Zuerst musst du alle Systempakete auf die neueste Version aktualisieren. Du kannst alle Pakete mit folgendem Befehl aktualisieren.

apt update -y
apt upgrade -y

Sobald alle Pakete aktualisiert sind, musst du auch einige zusätzliche Abhängigkeiten auf deinem Server installieren. Du kannst sie alle mit dem folgenden Befehl installieren.

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

Sobald alle Pakete installiert sind, kannst du mit dem nächsten Schritt fortfahren.

Docker und Docker Compose installieren

In diesem Beitrag werden wir Helpy mit Docker und Docker Compose installieren. Beide Pakete müssen also auf deinem Server installiert sein.

Als erstes fügst du den Docker GPG-Schlüssel und das Repository mit dem folgenden Befehl hinzu.

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"

Als Nächstes aktualisierst du den Repository-Cache mit dem folgenden Befehl.

apt update -y

Anschließend kannst du Docker und Docker compose mit dem folgenden Befehl installieren.

apt install docker-ce docker-compose -y

Sobald beide Pakete erfolgreich installiert sind, starte und aktiviere den Docker-Dienst mit dem folgenden Befehl.

systemctl start docker
systemctl enable docker

Überprüfe nun die Docker-Version mit dem folgenden Befehl.

docker -v

Du wirst die folgende Ausgabe erhalten.

Docker version 20.10.22, build 3a2c30b

Du kannst auch die Version von Docker Compose mit dem folgenden Befehl überprüfen.

docker-compose version

Du solltest die folgende Ausgabe sehen.

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

Helpy auf Ubuntu 22.04 installieren

Lade zunächst die neueste Version von Helpy mit dem folgenden Befehl aus dem GitHub-Repository herunter.

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

Sobald der Download abgeschlossen ist, navigiere mit folgendem Befehl in das Helpy-Verzeichnis.

cd helpy

Benenne dann die Helpy-Umgebungsdatei mit dem folgenden Befehl um.

cp docker/.env.sample docker/.env

Als Nächstes erstellst du das Docker-Image für Helpy mit dem folgenden Befehl.

docker-compose build

Du solltest die folgende Ausgabe sehen.

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

Du kannst alle Docker-Images mit dem folgenden Befehl überprüfen.

docker images

Du solltest die folgende Ausgabe erhalten.

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

Starte als Nächstes den Helpy- und Nginx-Container mit dem folgenden Befehl.

docker-compose up -d

Du solltest die folgende Ausgabe sehen.

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

Als Nächstes überprüfst du den Status aller laufenden Container mit dem folgenden Befehl.

docker-compose ps

Du solltest alle laufenden Container in der folgenden Ausgabe sehen.

      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

Warte einige Zeit, bis alle Container gestartet sind.

Zu diesem Zeitpunkt ist Helpy auf deinem System installiert und läuft. Du kannst jetzt mit dem nächsten Schritt fortfahren.

Zugriff auf das Helpy-Webinterface

Öffne nun deinen Webbrowser und rufe das Helpy-Webinterface über die URL http://your-server-ip auf. Du solltest die Willkommensseite von Helpy sehen.

Klicke auf die Schaltfläche Helpy einrichten. Du solltest die Seite zum Einrichten eines Administratorkontos sehen.

Gib deine E-Mail-Adresse, deinen vollständigen Namen, dein Unternehmen und dein Passwort ein und klicke dann auf die Schaltfläche Änderungen speichern. Du solltest die Seite zur Anpassung von Helpy sehen.

Klicke auf die Schaltfläche Skip for now. Du solltest die SMTP-Konfigurationsseite sehen.

Klicke auf die Schaltfläche Für den Moment überspringen. Du solltest die folgende Seite sehen.

Klicke jetzt auf die Schaltfläche Get Started! Auf der folgenden Seite solltest du das Helpy-Dashboard sehen.

Klicke auf die Schaltfläche Benutzer. Du solltest die folgende Seite sehen.

Klicke auf die Schaltfläche Neuen Benutzer erstellen. Du solltest die folgende Seite sehen.

Gib deine Benutzerdaten ein und klicke auf die Schaltfläche Änderungen speichern, um einen neuen Benutzer anzulegen.

Du kannst auch auf die Schaltfläche Berichte klicken, um deine Ticketberichte auf der folgenden Seite zu sehen.

Fazit

Herzlichen Glückwunsch! Du hast Helpy Customer Helpdesk erfolgreich auf Ubuntu 22.04 installiert. Du kannst Helpy jetzt in deinem Unternehmen einsetzen, um die Fragen deiner Kunden von einer zentralen Stelle aus zu beantworten. Wenn du noch Fragen hast, kannst du dich gerne an mich wenden.

Das könnte dich auch interessieren …