Docker-Installation

Zammad kann per Docker Compose installiert werden. Sie können sogar grafische Docker-Oberflächen wie Portainer verwenden.

INFO

Wir bieten keinen Support in Bezug auf Docker (-Compose) oder Portainer-spezifische Probleme. Wenn Sie sich dafür entscheiden, Zammad per Docker zu installieren, kann Support nur für Zammad als Anwendung geleistet werden.

Voraussetzungen

• Eine funktionierende Docker Compose-Umgebung

• Mindestens 4GB Arbeitsspeicher zum Ausführen der Container

• Erhöhen Sie das Speicherlimit für Elasticsearch auf Linux-Hosts:

  sudo sysctl -w vm.max_map_count=262144

Installation mit Portainer

Der einfachste Weg, Zammad zum Laufen zu bringen, ist über eine grafische Docker-Oberfläche. Wir empfehlen Portainer. Installationsanweisungen finden Sie in der Portainer Dokumentation.

Schritt 1: Stack hinzufügen

Wählen Sie in der Portainer-GUI (z.B. https://yourdomain.tld:9443) Ihre Zielumgebung aus, wählen Sie Stacks und klicken Sie auf Add stack, wie Sie im Screenshot unten sehen können.

Schritt 2: Aus dem Repository erstellen

Wechseln Sie zur Repository "Build Method" und geben Sie die folgenden Informationen an:

• Name: Geben Sie einen Namen für den Stack ein
• Repository URL: https://github.com/zammad/zammad-docker-compose
• Repository reference: refs/heads/master
• Compose path: docker-compose.yml (default)

Falls unsere Standardumgebung nicht Ihren Vorstellungen entspricht, können Sie den Stack mithilfe von vordefinierten Szenarien anpassen und Umgebungsvariablen verwenden. Weitere Informationen finden Sie im Abschnitt Anpassung weiter unten.

Schritt 3: Starten des Stacks

Klicken Sie schließlich auf die Schaltfläche Deploy the stack. Beim ersten Mal kann es einige Zeit dauern, bis die Docker-Images abgerufen werden.

Nachdem der Stack hochgefahren ist, können Sie über den konfigurierten Docker-Host und -Port auf Zammad zugreifen, z.B. http://localhost:8080/.

Installation per Docker Compose

Schritt 1: Klonen des GitHub Repo

git clone https://github.com/zammad/zammad-docker-compose.git

Stellen Sie sicher, dass Sie git pull regelmäßig ausführen, um Aktualisierungen zu erhalten. Alternativ können Sie die Dateien auch von der Release Seite herunterladen.

Schritt 2: Umgebung nach Bedarf anpassen

Falls unsere Standardumgebung nicht Ihren Vorstellungen entspricht, können Sie den Stack mithilfe von vordefinierten Szenarien anpassen und Umgebungsvariablen verwenden. Weitere Informationen finden Sie im Abschnitt Anpassung weiter unten.

Schritt 3: Starten des Stacks

cd zammad-docker-compose

docker compose up -d

Optional: Verwenden Sie eine zusätzliche .yml-Datei, um ein vordefiniertes Szenario zu verwenden. Springen Sie zum Bereich Anpassen des Zammad-Stacks für weitere Informationen.

Nachdem der Stack hochgefahren ist, können Sie über den konfigurierten Docker-Host und -Port auf Zammad zugreifen, z.B. http://localhost:8080/.

Stack per HTTPS freigeben

Um einen Zammad-Stack im Internet zu veröffentlichen, muss er über das HTTPS-Protokoll gesichert werden. Um dies zu erreichen, ohne den Zammad-Stack zu verändern, haben Sie folgende Möglichkeiten:

• Verwenden Sie einen Reverse-Proxy wie Nginx Proxy Manager (NPM). Er hat eine grafische Benutzeroberfläche, die eine einfache Let's Encrypt-Integration ermöglicht.
• Verwenden Sie einen Cloudflare-Tunnel, der eine SSL-Terminierung ermöglicht.

Beide Szenarien werden auf der separaten Seite Docker Compose Szenarien beschrieben.

Anpassen des Zammad-Stacks

Der Zammad-Stack kann durch das Laden zusätzlicher Szenario-Dateien für gängige Anwendungsfälle angepasst werden. Sie können den Stack zum Beispiel mit einem integrierten Nginx Proxy Manager (NPM) oder mit deaktivierten PostgreSQL- oder Elasticsearch-Diensten bereitstellen, falls Sie diese Dienste bereits nutzen.

Bitte lesen Sie unter Docker Compose Szenarien weiter.

Um den Stack und die Einstellungen anzupassen, verwenden Sie Docker-spezifische Umgebungsvariablen.

Ausführen von Befehlen im Stack

Führen Sie Befehle in Ihrem Docker Stack aus, indem Sie rails oder rake über eine der folgenden Methoden mit Hilfe von bundle exec aufrufen.

Suchen Sie den laufenden Rails-Container In der Portainer GUI und klicken Sie auf das Exec Console Icon in der Spalte "Quick Actions", wählen Sie den Standard-Entrypoint /bin/bash und klicken Connect.

Rufen Sie die interaktive Rails-Konsole auf, indem Sie folgenden Befehl ausführen:

bundle exec rails c

Führen Sie einen Befehl direkt aus:

bundle exec rails r '...Ihren Rails-Befehl...'