Zum Inhalt springen

Znuny mit Docker Compose installieren

Docker Compose ist der schnellste Weg zu einem Znuny-Testsystem, einer Demo oder einer Staging-Umgebung. Nutzen Sie bevorzugt das offizielle Projekt znuny/znuny-docker. Community-Stacks bleiben sinnvoll, wenn Sie einen Web-Installer, Znuny-6.x-LTS-Extras oder PostgreSQL brauchen.

Verwandte Themen: Znuny Docker im Betrieb · Staging-System · Offizielle Installationsdoku

StackGeeignet fürZnuny-VersionenErste Anmeldung
znuny/znuny-docker (offiziell)Getrennt httpd + Daemon + MariaDB7.3.x (Build-Arg ZNUNY_VERSION)Auto-Install; Admin-Passwort aus .env
Erik-Donath/znuny-dockerWeb-Installer-Workflow7.1+http://<host>:8080/znuny/installer.pl
juanluisbaptiste/docker-otrsEingebaute Backups, SMTP-Relay6.x LTSVorkonfiguriert oder /otrs/installer.pl

Diese Anleitung nutzt znuny/znuny-docker. Compose liest docker-compose.yml oder compose.yml — das offizielle Repo verwendet docker-compose.yml.

KomponenteMinimumEmpfohlen (Staging)
CPU2 Kerne4+ Kerne
RAM4 GB8 GB oder mehr (Defaults reservieren ~5 GB über die Services)
Disk20 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“

Unter Windows oder macOS: Docker Desktop.

Terminal-Fenster
docker --version
docker compose version
Terminal-Fenster
sudo git clone https://github.com/znuny/znuny-docker.git /opt/znuny-docker
cd /opt/znuny-docker

docker-compose.yml, dockerfiles/ und .env.example vor dem Start prüfen.

Terminal-Fenster
cp .env.example .env

Alle drei Pflichtpasswörter setzen (sonst startet Compose nicht):

ROOT_PASS=<sicheres_mariadb_root>
DB_USER_PASS=<sicheres_znuny_db>
ZNUNY_ADMIN_PASS=<sicheres_admin>

Nützliche optionale Variablen:

VariableDefaultZweck
external_port80HTTP-Port auf dem Host
DB_HOSTznuny-dbDatenbank-Hostname im Stack
ZNUNY_IMAGE_TAGlatestTag beim Pull vorgebauter Images
CONTAINER_REGISTRYznunyghcr.io/znuny/znuny-docker zum Pullen statt Bauen
DEFAULT_INTERFACEagentStandard-UI: agent oder customer

Lokal bauen (lädt den Znuny-Tarball; Default in der Dockerfile ist 7.3.1):

Terminal-Fenster
sudo docker compose up -d --build

Oder offizielle Images ziehen:

CONTAINER_REGISTRY=ghcr.io/znuny/znuny-docker
ZNUNY_IMAGE_TAG=stable
Terminal-Fenster
sudo docker compose up -d

Release beim Build festlegen:

Terminal-Fenster
sudo docker compose build --build-arg ZNUNY_VERSION=7.3.1 znuny-base
sudo docker compose up -d --build

ZNUNY_VERSION akzeptiert auch nightly und lts-nightly.

Gesundheit prüfen:

Terminal-Fenster
sudo docker compose ps
sudo docker compose logs -f znuny-httpd
ServiceContainerRolle
znuny-httpdznuny_httpdApache, Erstinstallation
znuny-daemonznuny_daemonHintergrundjobs
znuny-dbznuny_dbMariaDB

Der erste Start kann mehrere Minuten dauern (start_period von httpd: 300s).

http://<server-ip>/znuny/

Bei geändertem external_port diesen Port nutzen. Anmeldung mit dem initialen Admin-Konto und ZNUNY_ADMIN_PASS. Kein installer.pl im offiziellen Stack.

Terminal-Fenster
# TLS mit Let's Encrypt
sudo docker compose -f docker-compose.yml -f docker-compose.traefik.yml up -d --build

ZNUNY_DOMAIN und ACME_EMAIL in .env setzen.

Terminal-Fenster
# Vorhandene MariaDB/MySQL
sudo docker compose -f docker-compose.yml -f docker-compose.external-db.yml up -d --build

DB_HOST, DB_NAME, DB_USER und DB_USER_PASS auf den externen Server setzen. ROOT_PASS bleibt in der Basisdatei Pflicht, wird aber nicht genutzt.

Terminal-Fenster
sudo docker exec -u znuny znuny_daemon /opt/znuny/bin/znuny.Console.pl List
sudo docker exec -u znuny znuny_daemon /opt/znuny/bin/znuny.Console.pl Maint::Cache::Delete
VolumeInhalt
ZnunyAppAnwendungsdateien
ZnunyPersistentConfig.pm, Version, Restart-Trigger
MariaDBVolDatenbankdateien

Vor Updates sichern — siehe Znuny Docker im Betrieb.

external_port öffnen (Standard 80) oder TLS mit Traefik / einem anderen Reverse-Proxy beenden.

  1. MariaDBVol, ZnunyApp und ZnunyPersistent sichern.
  2. Offizielles README lesen — der Upgrade-Prozess ist noch unvollständig.
  3. Lokaler Build: docker compose build --build-arg ZNUNY_VERSION=<neu> znuny-base, dann docker compose up -d --build.
  4. Vorbaut: ZNUNY_IMAGE_TAG setzen, dann docker compose pull && docker compose up -d.

Der httpd-Entrypoint vergleicht /persistent/version und startet upgrade.sh bei Versionsunterschied.

Container beenden sich wegen unvollständiger .env

Compose verlangt ROOT_PASS, DB_USER_PASS und ZNUNY_ADMIN_PASS.

Port 80 bereits belegt

external_port=8080 (oder anderer freier Port) in .env setzen und Stack neu erzeugen.

Daemon nicht healthy

httpd muss zuerst healthy sein (Install/Upgrade). docker compose logs znuny-httpd prüfen.

Logs / Stoppen

Terminal-Fenster
sudo docker compose logs -f znuny-httpd
sudo docker compose logs -f znuny-daemon
sudo docker compose logs -f znuny-db
sudo docker compose down # behält Volumes
sudo docker compose down --volumes # löscht Daten

Nutzen Sie diese, wenn der offizielle Stack nicht passt.

Terminal-Fenster
sudo git clone https://github.com/Erik-Donath/znuny-docker.git /opt/znuny-docker-community
cd /opt/znuny-docker-community
# Standardpasswörter in docker-compose.yaml ersetzen
sudo docker compose up --build -d

http://<host>:8080/znuny/installer.pl öffnen. Datenbank-Host ist db, nicht localhost. Typische Services: znuny-app und db.

Siehe juanluisbaptiste/docker-otrs für SMTP-Relay und automatische Backups.

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

Welchen Docker-Compose-Stack sollte ich für Znuny wählen und warum?

Für eine schnelle Test-, Demo- oder Staging-Umgebung ist der offizielle Stack znuny/znuny-docker die bevorzugte Wahl. Er ist modern, nutzt GHCR-Images und bietet eine automatische Installation ohne den Web-Installer. Beachten Sie jedoch, dass dieser Stack noch als experimentell gilt und Upgrades manuelle Schritte erfordern können. Für Produktionsumgebungen empfiehlt Znuny weiterhin die offizielle Installationsdokumentation oder ein Anbieter-Setup. Community-Stacks wie Erik-Donath/znuny-docker sind sinnvoll, wenn Sie den klassischen Web-Installer-Workflow bevorzugen, während juanluisbaptiste/docker-otrs für ältere Znuny-6.x-LTS-Versionen mit eingebauten Backup-Funktionen geeignet ist.

Quellen:

Welche Systemvoraussetzungen gelten für die Installation von Znuny mit Docker Compose?

Für eine reibungslose Installation und den Betrieb von Znuny mit Docker Compose sind bestimmte Systemvoraussetzungen zu beachten. Für eine Staging-Umgebung werden mindestens 4 CPU-Kerne, 8 GB RAM oder mehr (die Standarddienste reservieren etwa 5 GB), 40 GB+ freier SSD-Speicherplatz, Docker 20.10 (oder aktueller), Docker Compose v2 (oder aktueller) und Git 2.17 (oder aktueller) empfohlen. Die Mindestanforderungen liegen bei 2 CPU-Kernen, 4 GB RAM und 20 GB freiem Speicherplatz. Unter Windows oder macOS wird die Nutzung von Docker Desktop empfohlen, um diese Anforderungen zu erfüllen und die notwendigen Komponenten bereitzustellen.

Quellen:

Wie konfiguriere ich die `.env`-Datei für den offiziellen Znuny Docker-Stack?

Nachdem Sie das offizielle Projekt znuny/znuny-docker geklont haben, müssen Sie eine .env-Datei anlegen, indem Sie .env.example kopieren. Es ist zwingend erforderlich, alle drei Pflichtpasswörter zu setzen, da der Compose-Stack sonst nicht startet: ROOT_PASS (für MariaDB-Root), DB_USER_PASS (für den Znuny-Datenbankbenutzer) und ZNUNY_ADMIN_PASS (für das initiale Znuny-Admin-Konto). Darüber hinaus gibt es nützliche optionale Variablen wie external_port (Standard 80) zur Festlegung des Host-Ports, DB_HOST für den Datenbank-Hostname, ZNUNY_IMAGE_TAG für den Image-Tag und CONTAINER_REGISTRY zum Pullen von Images anstelle des lokalen Bauens. DEFAULT_INTERFACE kann auf agent oder customer gesetzt werden.

Quellen:

Wie starte ich den Znuny Docker-Stack und greife darauf zu?

Um den Znuny Docker-Stack zu starten, können Sie entweder die Images lokal bauen, indem Sie sudo docker compose up -d --build ausführen (Standard ist Znuny 7.3.1), oder offizielle Images von ghcr.io/znuny/znuny-docker ziehen, indem Sie CONTAINER_REGISTRY=ghcr.io/znuny/znuny-docker und ZNUNY_IMAGE_TAG=stable in Ihrer .env-Datei setzen und dann sudo docker compose up -d verwenden. Sie können auch eine spezifische Znuny-Version beim Build festlegen. Nach dem Start können Sie den Zustand der Services mit sudo docker compose ps und die Logs mit sudo docker compose logs -f znuny-httpd überprüfen. Der erste Start kann einige Minuten dauern. Greifen Sie auf Znuny über http://<server-ip>/znuny/ zu. Die Anmeldung erfolgt mit dem initialen Admin-Konto und dem in .env festgelegten ZNUNY_ADMIN_PASS. Der installer.pl wird im offiziellen Stack nicht verwendet.

Quellen:

Wie richte ich HTTPS mit Traefik oder eine externe Datenbank für meinen Znuny Docker-Stack ein?

Der offizielle Znuny Docker-Stack unterstützt die Konfiguration von HTTPS mittels Traefik und die Anbindung an eine externe Datenbank über zusätzliche Compose-Dateien. Für HTTPS mit Let's Encrypt und Traefik starten Sie den Stack mit sudo docker compose -f docker-compose.yml -f docker-compose.traefik.yml up -d --build. Stellen Sie sicher, dass ZNUNY_DOMAIN und ACME_EMAIL in Ihrer .env-Datei korrekt gesetzt sind. Wenn Sie eine vorhandene MariaDB/MySQL-Datenbank nutzen möchten, verwenden Sie sudo docker compose -f docker-compose.yml -f docker-compose.external-db.yml up -d --build. Dabei müssen DB_HOST, DB_NAME, DB_USER und DB_USER_PASS in .env auf die externen Serverdaten angepasst werden. Beachten Sie, dass ROOT_PASS in der Basisdatei weiterhin Pflicht ist, aber bei externer Datenbank nicht genutzt wird.

Quellen:

Welche Schritte sind nach der Installation des Znuny Docker-Stacks wichtig?

Nach der erfolgreichen Installation des Znuny Docker-Stacks gibt es einige wichtige Schritte und Informationen zu beachten. Für Konsolenbefehle können Sie sudo docker exec -u znuny znuny_daemon /opt/znuny/bin/znuny.Console.pl List oder Maint::Cache::Delete verwenden. Die persistenten Daten werden in spezifischen Docker-Volumes gespeichert: ZnunyApp für Anwendungsdateien, ZnunyPersistent für Config.pm und Restart-Trigger sowie MariaDBVol für Datenbankdateien. Es ist entscheidend, diese Volumes vor Updates zu sichern. Bezüglich der Firewall müssen Sie den external_port (Standard 80) öffnen oder TLS mit Traefik / einem anderen Reverse-Proxy beenden, um den Zugriff auf Znuny zu ermöglichen.

Quellen: