Freescout kostenloses Ticketsystem auf VPS installieren

Lesedauer 4 Minuten

Inhaltsverzeichnis

• 0. Überblick
• 1. FreeScout installieren
• 2. FreeScout starten
• 3. Sprache anpassen
• 4. SMTP Einstellungen anpassen

0. Überblick

• Verwendetes System: Debian 11 64 bit
• Genutzter User: Ich nehme alles als „root“ vor
• Zeitdauer: ca. 10 Minuten
• Schwierigkeit: Einfach. Nur Code kopieren 😉
• Besonderheiten:
  • Grundlage ist folgende Anleitung: Traefik Reverseproxy auf VPS 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: Traefik Reverseproxy auf VPS 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@easyname.at 

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.