Znuny schlüsselfertig installieren lassen
Keine Experimente im Produktivbetrieb: Softoft übernimmt die professionelle Znuny-Installation, Docker- oder Native-Setup, Systemhärtung und Basiskonfiguration.
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
| Stack | Geeignet für | Znuny-Versionen | Erste Anmeldung |
|---|---|---|---|
| znuny/znuny-docker (offiziell) | Getrennt httpd + Daemon + MariaDB | 7.3.x (Build-Arg ZNUNY_VERSION) | Auto-Install; Admin-Passwort aus .env |
| Erik-Donath/znuny-docker | Web-Installer-Workflow | 7.1+ | http://<host>:8080/znuny/installer.pl |
| juanluisbaptiste/docker-otrs | Eingebaute Backups, SMTP-Relay | 6.x LTS | Vorkonfiguriert 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.
| Komponente | Minimum | Empfohlen (Staging) |
|---|---|---|
| CPU | 2 Kerne | 4+ Kerne |
| RAM | 4 GB | 8 GB oder mehr (Defaults reservieren ~5 GB über die Services) |
| Disk | 20 GB frei | 40 GB+ (SSD) |
| Docker | 20.10 | aktuell |
| Docker Compose | v2 | aktuell |
| Git | 2.17 | aktuell |
Unter Windows oder macOS: Docker Desktop.
docker --versiondocker compose versionsudo git clone https://github.com/znuny/znuny-docker.git /opt/znuny-dockercd /opt/znuny-dockerdocker-compose.yml, dockerfiles/ und .env.example vor dem Start prüfen.
.env anlegencp .env.example .envAlle 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:
| Variable | Default | Zweck |
|---|---|---|
external_port | 80 | HTTP-Port auf dem Host |
DB_HOST | znuny-db | Datenbank-Hostname im Stack |
ZNUNY_IMAGE_TAG | latest | Tag beim Pull vorgebauter Images |
CONTAINER_REGISTRY | znuny | ghcr.io/znuny/znuny-docker zum Pullen statt Bauen |
DEFAULT_INTERFACE | agent | Standard-UI: agent oder customer |
Lokal bauen (lädt den Znuny-Tarball; Default in der Dockerfile ist 7.3.1):
sudo docker compose up -d --buildOder offizielle Images ziehen:
CONTAINER_REGISTRY=ghcr.io/znuny/znuny-dockerZNUNY_IMAGE_TAG=stablesudo docker compose up -dRelease beim Build festlegen:
sudo docker compose build --build-arg ZNUNY_VERSION=7.3.1 znuny-basesudo docker compose up -d --buildZNUNY_VERSION akzeptiert auch nightly und lts-nightly.
Gesundheit prüfen:
sudo docker compose pssudo docker compose logs -f znuny-httpd| Service | Container | Rolle |
|---|---|---|
znuny-httpd | znuny_httpd | Apache, Erstinstallation |
znuny-daemon | znuny_daemon | Hintergrundjobs |
znuny-db | znuny_db | MariaDB |
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.
# TLS mit Let's Encryptsudo docker compose -f docker-compose.yml -f docker-compose.traefik.yml up -d --buildZNUNY_DOMAIN und ACME_EMAIL in .env setzen.
# Vorhandene MariaDB/MySQLsudo docker compose -f docker-compose.yml -f docker-compose.external-db.yml up -d --buildDB_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.
sudo docker exec -u znuny znuny_daemon /opt/znuny/bin/znuny.Console.pl Listsudo docker exec -u znuny znuny_daemon /opt/znuny/bin/znuny.Console.pl Maint::Cache::Delete| Volume | Inhalt |
|---|---|
ZnunyApp | Anwendungsdateien |
ZnunyPersistent | Config.pm, Version, Restart-Trigger |
MariaDBVol | Datenbankdateien |
Vor Updates sichern — siehe Znuny Docker im Betrieb.
external_port öffnen (Standard 80) oder TLS mit Traefik / einem anderen Reverse-Proxy beenden.
MariaDBVol, ZnunyApp und ZnunyPersistent sichern.docker compose build --build-arg ZNUNY_VERSION=<neu> znuny-base, dann docker compose up -d --build.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
sudo docker compose logs -f znuny-httpdsudo docker compose logs -f znuny-daemonsudo docker compose logs -f znuny-dbsudo docker compose down # behält Volumessudo docker compose down --volumes # löscht DatenNutzen Sie diese, wenn der offizielle Stack nicht passt.
sudo git clone https://github.com/Erik-Donath/znuny-docker.git /opt/znuny-docker-communitycd /opt/znuny-docker-community# Standardpasswörter in docker-compose.yaml ersetzensudo docker compose up --build -dhttp://<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.
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:
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:
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:
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:
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:
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: