Zum Inhalt springen

Znuny auf Ubuntu mit Docker installieren

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

  • Ubuntu 20.04 LTS
  • Ubuntu 22.04 LTS
  • Ubuntu 24.04 LTS

Neuere Releases funktionieren in der Regel, sofern eine aktuelle Docker-Version verfügbar 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] Das Paket docker-compose-v2 ist ab Ubuntu 22.04 verfügbar. Auf älteren Versionen 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 Ubuntu 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 Ubuntu-Versionen werden für die Installation von Znuny mit Docker unterstützt und welche Systemvoraussetzungen gibt es?

Für die Installation von Znuny mit Docker auf Ubuntu werden primär die Long Term Support (LTS)-Versionen Ubuntu 20.04 LTS, 22.04 LTS und 24.04 LTS unterstützt. Neuere Ubuntu-Releases funktionieren in der Regel ebenfalls, sofern eine kompatible und aktuelle Docker-Version verfügbar ist. Bezüglich der Systemvoraussetzungen wird ein Minimum von 2 CPU-Kernen, 4 GB RAM und 20 GB freiem Festplattenspeicher empfohlen. Für eine optimale Leistung und größere Umgebungen sind jedoch 4+ CPU-Kerne, 8 GB oder mehr RAM und mindestens 40 GB freier SSD-Speicher ratsam. Die verwendeten Docker- und Docker Compose-Versionen sollten mindestens 20.10 bzw. v2 sein, idealerweise die aktuellsten stabilen Versionen.

Quellen:

Wie installiere ich Docker, Docker Compose und Git auf Ubuntu für Znuny, insbesondere bei älteren Ubuntu-Versionen?

Die Installation erfolgt durch Aktualisierung der Paketquellen und anschließende Installation der benötigten Pakete. Führen Sie dazu sudo apt update gefolgt von sudo apt install -y docker.io docker-compose-v2 git aus. Es ist wichtig zu beachten, dass das Paket docker-compose-v2 erst ab Ubuntu 22.04 LTS standardmäßig verfügbar ist. Für ältere Ubuntu-Versionen wie 20.04 LTS müssen Sie entweder das offizielle Docker-Repository einrichten, um eine aktuelle Version von Docker Compose v2 zu erhalten, oder auf das ältere Legacy-Paket docker-compose zurückgreifen. Nach der Installation sollte der Docker-Dienst mit sudo systemctl enable --now docker aktiviert und gestartet werden, um sicherzustellen, dass er beim Systemstart automatisch läuft.

Quellen:

Muss ich Docker immer mit `sudo` verwenden, und wie kann ich dies vermeiden?

Standardmäßig erfordert die Ausführung von Docker-Befehlen administrative Rechte, was bedeutet, dass Sie sudo vor jedem docker-Kommando eingeben müssen. Dies ist eine Sicherheitsmaßnahme. Um Docker ohne sudo verwenden zu können, müssen Sie Ihren Benutzer zur docker-Gruppe hinzufügen. Dies geschieht mit dem Befehl sudo usermod -aG docker $USER. Nach der Ausführung dieses Befehls ist es notwendig, sich einmal vom System ab- und wieder anzumelden (oder das System neu zu starten), damit die Gruppenmitgliedschaft wirksam wird. Danach können Sie Docker-Befehle direkt als Ihr Benutzer ausführen, ohne sudo voranstellen zu müssen, was den Workflow erheblich vereinfacht.

Quellen:

Was ist der nächste Schritt, nachdem Docker und Docker Compose auf Ubuntu installiert wurden, um Znuny zu betreiben?

Nachdem Docker, Docker Compose und Git erfolgreich auf Ihrem Ubuntu-System installiert und konfiguriert wurden, ist der nächste Schritt die eigentliche Installation von Znuny mithilfe des Community-Compose-Stacks. Sie sollten die Anleitung zur Znuny mit Docker Compose Installation befolgen. Diese detaillierte Anleitung führt Sie durch das Klonen des Community-Compose-Projekts, die Konfiguration von MariaDB, das Ausführen des Znuny Web-Installers unter /znuny/installer.pl, sowie die Einrichtung von Volumes, die Durchführung von Updates und die Fehlerbehebung. Dieser Schritt ist entscheidend, um Znuny in einer produktionsbereiten Docker-Umgebung zu deployen und zu konfigurieren.

Quellen:

Wann sollte ich eine klassische Installation von Znuny ohne Docker in Betracht ziehen?

Eine klassische Installation von Znuny ohne Docker sollte in Betracht gezogen werden, wenn Sie eine Bare-Metal-Produktionsumgebung betreiben möchten und volle Kontrolle über das Betriebssystem und die einzelnen Komponenten bevorzugen. Dies kann der Fall sein, wenn Sie spezifische Anforderungen an die Systemkonfiguration haben, keine Virtualisierungsebene wünschen oder bereits eine etablierte Infrastruktur für die manuelle Verwaltung von Apache, MariaDB und Perl-Modulen unter Ubuntu besitzen. Für diese Szenarien empfiehlt es sich, der offiziellen Znuny-Installationsanleitung zu folgen, die detaillierte Schritte für die manuelle Einrichtung aller notwendigen Dienste und Abhängigkeiten bietet. Dies erfordert in der Regel mehr manuellen Aufwand bei der Installation und Wartung, bietet aber maximale Flexibilität.

Quellen: