-
Was ist ein vServer?
-
vServer und Sicherheit
-
vServer - Anwendungsfälle
-
vServer bei dogado
-
vServer und Plesk
-
vServer Betriebssyteme
-
vServer Glossar
0. Überblick
- Verwendetes System: Debian 11 64 bit vServer
- Genutzter User: Ich nehme alles als „root“ vor
- Zeitdauer: ca. 10 Minuten
- Schwierigkeit: Einfach. Nur Code kopieren 😉
- Besonderheiten:
- Grundlage ist folgende Anleitung: https://www.dogado.de/vps/vserver-anwendungsfaelle/traefik-reverseproxy-auf-vserver-installieren. Diese Anleitung muss zuerst ausgeführt werden.
- Die Installation von Docker / Docker Compose wird hier vorausgesetzt.
1. FreeScout installieren
1.1 Einleitung
FreeScout ist ein open source Helpdesk. Der Vorteil von FreeScout ist, dass es kostenlos auf dem eigenen Server betrieben werden kann. FreeScout kann auch um einige Funktionen mittels kostenpflichtiger Plugins erweitert werden. Die Liste offizieller Plugins gibt es hier: https://freescout.net/modules/
1.2 Infos zu yml Dateien
Bei yml Dateien ist es sehr wichtig, dass die Zeilen alle richtig eingerückt sind. Die Zeilen MÜSSEN immer mit der Leertaste eingerückt werden. Es dürfen KEINE Tabs enthalten sein. Ihr könnt den nachfolgenden Code immer online „überprüfen“ lassen. Die meisten Fehler entstehen nämlich durch die falsche Formatierung. Ein Dienst zum Überprüfen ist zum Beispiel: https://codebeautify.org/yaml-validator
1.3 Vorbereitung
Diese Anleitung basiert auf dem aktuellen Debian 10 Betriebssystem. FreeScout werden wir unter Docker realisieren. Dies ermöglicht uns später sehr schnelle Updates und eine schnelle Installation.
Um FreeScout neben anderen Diensten auf unserem Server betreiben zu können, nutzen wir hier den Reverse Proxy Traefik. Die Anleitung dazu finden Sie hier: https://www.dogado.de/vps/vserver-anwendungsfaelle/traefik-reverseproxy-auf-vserver-installieren
1.3.1 Verzeichnis erstellen
Wir erstellen uns ein neues Verzeichnis, in welchem wir später alle Daten von FreeScout abspeichen. Dazu geben wir folgendes in der Konsole ein:
mkdir -p /opt/containers/freescout/{data,logs,database}
Ihr könnt hier auch ein anderes Verzeichnis verwenden. Müsst dann aber die gesamte Anleitung entsprechend anpassen.
1.3.2 docker-compose.yml erstellen
Nun können wir mit der eigentlichen „Installation“ von FreeScout beginnen. Dazu öffnet ihr folgende Datei:
nano /opt/containers/freescout/docker-compose.yml
Nun kopiert ihr folgenden Code in die Datei. Dieser Code ist unser Bauplan für unseren FreeScout Container.
version: '2'
services:
freescout-app:
image: tiredofit/freescout
container_name: freescout-app
restart: unless-stopped
volumes:
- ./data:/data
- ./logs/:/www/logs
environment:
- DB_HOST=freescout-db
- DB_NAME=freescout
- DB_USER=freescout
- DB_PASS=freescout
- SITE_URL=https://freescout.euredomain.de
- ADMIN_EMAIL=admin@admin.com
- ADMIN_PASS=freescout
- ENABLE_SSL_PROXY=TRUE
- DISPLAY_ERRORS=FALSE
- TIMEZONE=Europe/Berlin
labels:
- "traefik.enable=true"
- "traefik.http.routers.freescout.entrypoints=http"
- "traefik.http.routers.freescout.rule=Host(`freescout.euredomain.de`)"
- "traefik.http.middlewares.freescout-https-redirect.redirectscheme.scheme=https"
- "traefik.http.routers.freescout.middlewares=freescout-https-redirect"
- "traefik.http.routers.freescout-secure.entrypoints=https"
- "traefik.http.routers.freescout-secure.rule=Host(`freescout.euredomain.de`)"
- "traefik.http.routers.freescout-secure.tls=true"
- "traefik.http.routers.freescout-secure.tls.certresolver=http"
- "traefik.http.routers.freescout-secure.service=freescout"
- "traefik.http.services.freescout.loadbalancer.server.port=80"
- "traefik.docker.network=proxy"
- "traefik.http.routers.freescout-secure.middlewares=secHeaders@file"
networks:
- proxy
- default
freescout-db:
image: tiredofit/mariadb
container_name: freescout-db
restart: unless-stopped
volumes:
- ./database:/var/lib/mysql
environment:
- ROOT_PASS=password
- DB_NAME=freescout
- DB_USER=freescout
- DB_PASS=freescout
networks:
- default
networks:
proxy:
external: true
Nun müssen wir noch einiges anpassen.
1.3.3 Hostname anpassen
Nun müsst ihr noch den Hostnamen anpassen, über welchen später FreeScout erreichbar sein soll.
Diese beiden Zeilen müsst ihr anpassen.
- "traefik.http.routers.freescout.rule=Host(`freescout.euredomain.de `)"
- "traefik.http.routers.freescout-secure.rule=Host(`freescout.euredomain.de`)"
In meinem Fall also:
- "traefik.http.routers.freescoutrule=Host(`freescout.testbereich.net`)"
- "traefik.http.routers.freescout-secure.rule=Host(`freescout.testbereich.net`)"
Wenn ihr FreeScout direkt auf eurer „Hauptdomain“ betreiben wollt, dann ändert ihr es folgendermaßen ab:
"traefik.http.routers.freescout.rule=Host(`www.euredomain.de`,`euredomain.de`)"
"traefik.http.routers.freescout-secure.rule=Host(`www.euredomain.de`,`euredomain.de`)"
1.3.4 Datenbank Passwort anpassen
Nachdem ihr den Hostnamen angepasst habt, müsst ihr noch das Datenbank Passwort anpassen. Vergebt ihr ein langes, sicheres Kennwort. Das Kennwort in den beiden Zeilen „DB_PASS“ identisch sein.
Folgende Zeilen müsst ihr ändern:
freescout-app:
- DB_PASS=freescout
freescout-db:
- ROOT_PASS=password
- DB_PASS=freescout
Ich ändere also meine Kennwörter ab. Dies könnte beispielsweise so sein:
freescout-app:
- DB_PASS=Adhafz234s
freescout-db:
- ROOT_PASS=Adjadh324fastA
- DB_PASS=Adhafz234s
1.3.5 FreeScout Admin anpassen
Nun passen wir noch die Einstellungen unseres FreeScout Administrators an.
Dazu passt ihr folgende Zeilen an:
ADMIN_EMAIL=admin@admin.com
ADMIN_PASS=freescout
Bei mir sieht es dann so aus:
ADMIN_EMAIL=admin@dogado.de
ADMIN_PASS=Adahas2341
1.3.6 Site URL anpassen
Nun müsst ihr noch einen weiteren Wert ändern. Gebt hier die URL an, welche ihr im Schritt 1.3.3 vergeben habt.
- SITE_URL=https://freescout.euredomain.de
Bei mir sieht es dann so aus:
- SITE_URL=https://freescout.testbereich.net
Nun haben wir alles fertig konfiguriert und können FreeScout zum ersten Mal starten.
2. FreeScout starten
Gebt nun folgendes ein, um euren FreeScout Container zu starten:
docker compose -f /opt/containers/freescout/docker-compose.yml up -d
Beim ersten Start des Containers wird FreeScout initialisiert. Dies bedeutet, dass die Datenbank eingerichtet, eure Einstellungen übernommen werden und vieles mehr.
Geht nun mit eurem Webbrowser auf eure Webseite (z.B. freescout.euredomain.de). Dies sollte so aussehen. Hier könnt ihr euch nun mit eurem Administrator Account aus Schritt 1.3.5 anmelden.
Nun seht ihr folgendes Dashboard.
3. Sprache anpassen
Um die Sprache anzupassen, klickt ihr auf „Manage“ oben links.
Wählt hier nun „Settings“ aus.
Hier könnt ihr nun die Sprache anpassen sowie weitere Einstellungen vornehmen.
Hier ein Überblick aller unterstützter Sprachen.
4. SMTP Einstellungen anpassen
Nun passen wir noch die SMTP Einstellungen an, damit euer Server E-Mails verschicken kann. Klickt dazu neben „Settings“ auf die „3 Balken“.
Wählt hier nun „Mail Settings“ aus.
Hier wählt ihr nun „SMTP“ aus.
Nun könnt ihr die SMTP Zugangsdaten eures E-Mail Providers eingeben.