Zum Inhalt springen

Znuny auf Debian mit Docker installieren

Diese Anleitung installiert Docker und Docker Compose unter Debian, damit Sie Znuny mit der Docker-Compose-Installation betreiben können.

  • Debian 11 (Bullseye)
  • Debian 12 (Bookworm)

Ältere Versionen (Debian 10) funktionieren meist, sofern eine aktuelle Docker-Version installierbar ist.

KomponenteMinimumEmpfohlen
CPU2 Kerne4+ Kerne
RAM4 GB8 GB oder mehr
Festplatte20 GB frei40 GB+ (SSD)
Docker20.10aktuell
Docker Composev2aktuell
Git2.17aktuell

Schritt 1: Docker, Docker Compose und Git installieren

Abschnitt betitelt „Schritt 1: Docker, Docker Compose und Git installieren“

Paketquellen aktualisieren und installieren:

Terminal-Fenster
sudo apt update
sudo apt install -y docker.io docker-compose-v2 git

[!NOTE] Auf älteren Debian-Versionen ohne Paket docker-compose-v2 das offizielle Docker-Repository einrichten oder das Legacy-Paket docker-compose nutzen.

Docker aktivieren und starten:

Terminal-Fenster
sudo systemctl enable --now docker

Optional — Docker ohne sudo (danach ab- und wieder anmelden):

Terminal-Fenster
sudo usermod -aG docker $USER

Prüfen:

Terminal-Fenster
docker --version
docker compose version

Mit dem vollständigen Stack-Setup fortfahren:

Znuny mit Docker Compose installieren

Dort werden ein Community-Compose-Projekt geklont, MariaDB konfiguriert, der Web-Installer unter /znuny/installer.pl ausgeführt sowie Volumes, Updates und Fehlerbehebung beschrieben.

Für Produktion auf Bare Metal die offizielle Znuny-Installationsanleitung für Apache, MariaDB und Perl-Module unter Debian befolgen.

Znuny schlüsselfertig installieren lassen

Keine Experimente im Produktivbetrieb: Softoft übernimmt die professionelle Znuny-Installation, Docker- oder Native-Setup, Systemhärtung und Basiskonfiguration.

Häufig gestellte Fragen

Welche Debian-Versionen werden für die Installation von Znuny mit Docker unterstützt?

Für die Installation von Znuny mit Docker werden primär Debian 11 (Codename Bullseye) und Debian 12 (Codename Bookworm) offiziell unterstützt und empfohlen. Diese Versionen gewährleisten die Kompatibilität mit den neuesten Docker- und Docker Compose-Paketen, die für einen reibungslosen Betrieb des Znuny-Community-Stacks erforderlich sind. Ältere Debian-Versionen, wie beispielsweise Debian 10 (Buster), können unter Umständen ebenfalls funktionieren, jedoch nur, wenn eine aktuelle und kompatible Docker-Version erfolgreich installiert werden kann. Es ist wichtig sicherzustellen, dass die installierte Docker-Engine mindestens Version 20.10 und Docker Compose Version 2 (oder höher) aufweist, um alle Funktionen und die Stabilität des Znuny-Docker-Setups zu gewährleisten. Bei älteren Debian-Versionen muss möglicherweise das offizielle Docker-Repository hinzugefügt werden, um die benötigten Paketversionen zu erhalten.

Quellen

Wie installiere ich Docker, Docker Compose und Git auf Debian für Znuny?

Die Installation von Docker, Docker Compose und Git auf Debian für Znuny erfolgt in wenigen Schritten über die Paketverwaltung apt. Zuerst aktualisieren Sie Ihre Paketquellen mit sudo apt update, um sicherzustellen, dass Sie die neuesten Paketinformationen erhalten. Anschließend installieren Sie die erforderlichen Pakete mit sudo apt install -y docker.io docker-compose-v2 git. Das Paket docker.io stellt die Docker-Engine bereit, docker-compose-v2 die aktuelle Version von Docker Compose und git wird benötigt, um den Znuny-Community-Compose-Stack zu klonen. Nach der Installation aktivieren und starten Sie den Docker-Dienst mit sudo systemctl enable --now docker. Optional können Sie Ihren Benutzer zur Docker-Gruppe hinzufügen (sudo usermod -aG docker $USER), um Docker-Befehle ohne sudo ausführen zu können; hierfür ist nach der Änderung ein Ab- und erneutes Anmelden erforderlich. Beachten Sie, dass auf älteren Debian-Versionen das Paket docker-compose-v2 möglicherweise nicht direkt verfügbar ist; in diesem Fall müssen Sie das offizielle Docker-Repository einrichten oder auf das Legacy-Paket docker-compose zurückgreifen.

Quellen

Welche Systemvoraussetzungen gelten für Znuny mit Docker auf Debian?

Für den reibungslosen Betrieb von Znuny mit Docker auf Debian sind bestimmte Systemvoraussetzungen zu beachten, die sowohl Mindestanforderungen als auch Empfehlungen umfassen. Bezüglich der CPU werden mindestens 2 Kerne benötigt, wobei 4 oder mehr Kerne für eine optimale Performance empfohlen werden, insbesondere bei höherer Benutzerlast oder komplexen Automatisierungen. Der Arbeitsspeicher (RAM) sollte mindestens 4 GB betragen; für eine produktive Umgebung oder größere Installationen sind 8 GB oder mehr ratsam. Für die Festplatte sind mindestens 20 GB freier Speicherplatz erforderlich, wobei 40 GB oder mehr auf einer SSD dringend empfohlen werden, um schnelle Datenbankzugriffe und Dateisystemoperationen zu gewährleisten. Die installierte Docker-Version sollte mindestens 20.10 sein, während für Docker Compose die Version v2 (oder neuer) vorausgesetzt wird. Git sollte in Version 2.17 oder aktueller vorhanden sein, um den Community-Compose-Stack korrekt klonen zu können. Die Einhaltung dieser Empfehlungen trägt maßgeblich zur Stabilität und Performance Ihrer Znuny-Instanz bei.

Quellen

Was ist der nächste Schritt nach der Installation von Docker auf Debian, um Znuny zu betreiben?

Nachdem Docker, Docker Compose und Git erfolgreich auf Ihrem Debian-System installiert und konfiguriert wurden, ist der nächste Schritt die eigentliche Bereitstellung von Znuny mithilfe des Docker-Compose-Stacks. Dieser Prozess wird in der separaten Anleitung zur Znuny mit Docker Compose Installation detailliert beschrieben. Im Wesentlichen klonen Sie dort ein Community-Compose-Projekt, das alle notwendigen Konfigurationsdateien und Dienste für Znuny enthält. Dazu gehört die Einrichtung einer MariaDB-Datenbank in einem separaten Container, die Konfiguration des Webservers (oft Apache) und die Vorbereitung der Znuny-Anwendung selbst. Nach dem Start des Stacks führen Sie den Znuny-Web-Installer aus, der typischerweise unter /znuny/installer.pl erreichbar ist, um die Datenbankverbindung herzustellen und die Grundkonfiguration abzuschließen. Die Anleitung behandelt auch wichtige Aspekte wie persistente Volumes für Daten, das Einspielen von Updates und grundlegende Fehlerbehebung, um einen stabilen und wartbaren Znuny-Betrieb zu gewährleisten.

Quellen

Was sind die Unterschiede zwischen der Docker-basierten und der klassischen Znuny-Installation auf Debian?

Die Docker-basierte Installation von Znuny unterscheidet sich grundlegend von der klassischen Installation ohne Docker, insbesondere in Bezug auf die Systemarchitektur und Wartung. Bei der Docker-Installation wird Znuny in isolierten Containern betrieben, wobei jeder Dienst (z.B. Znuny-Anwendung, MariaDB, Webserver) in einem eigenen Container läuft. Dies bietet Vorteile wie Portabilität, einfache Skalierbarkeit und eine saubere Trennung der Abhängigkeiten vom Host-System. Der hier beschriebene Community-Compose-Stack nutzt Docker Compose, um diese Container zu orchestrieren und eine produktionsbereite Umgebung schnell bereitzustellen. Im Gegensatz dazu erfordert die klassische Installation auf Bare Metal die manuelle Einrichtung und Konfiguration aller Komponenten direkt auf dem Betriebssystem. Dies beinhaltet die Installation und Konfiguration von Apache als Webserver, MariaDB als Datenbank und aller erforderlichen Perl-Module. Während die klassische Methode volle Kontrolle über jede Komponente bietet, ist sie oft komplexer in der Einrichtung und Wartung, da alle Abhängigkeiten und Konfigurationen manuell verwaltet werden müssen. Die offizielle Znuny-Installationsanleitung ist hierfür die maßgebliche Quelle.

Quellen

Gibt es offizielle Docker-Images oder einen offiziellen Docker-Compose-Stack für Znuny?

Obwohl es keine offiziellen Docker-Images direkt von Znuny.com gibt, die vergleichbar mit vielen anderen großen Open-Source-Projekten sind, existiert ein sehr aktiver und etablierter Community-Compose-Stack. Dieser wird von Erik Donath auf GitHub unter Erik-Donath/znuny-docker gepflegt und ist die Grundlage für die in dieser Dokumentation empfohlene Docker-Compose-Installation. Dieser Stack bietet eine produktionsreife Umgebung mit Apache2, Cron und dem Znuny Daemon, wobei MariaDB als separater Container bereitgestellt wird. Darüber hinaus gibt es weitere Community-Projekte wie das Docker-Image von juanluisbaptiste/znuny auf Docker Hub, das als Fork des ursprünglichen OTRS Community Edition Docker-Images dient. Diese Community-Lösungen sind weit verbreitet und werden aktiv weiterentwickelt, um Znuny effizient und stabil in einer Container-Umgebung zu betreiben. Sie bieten eine flexible und moderne Möglichkeit, Znuny zu deployen, ohne die Komplexität einer manuellen Installation aller Abhängigkeiten auf dem Host-System.

Quellen