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

Experimentelles offizielles Docker

Der offizielle Stack wird aktiv weiterentwickelt. Upgrades können manuelle Schritte brauchen. Für Produktionsarchitektur folgen Sie weiterhin doc.znuny.org oder einem Anbieter-Setup, sofern Sie das Risiko nicht bewusst eingehen.

Docker-Stack auswählen

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.

Systemvoraussetzungen

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

Schritt 1: Docker, Docker Compose und Git installieren

• Ubuntu
• Debian

Unter Windows oder macOS: Docker Desktop.

docker --version
docker compose version

Schritt 2: Offizielles Projekt klonen

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.

Schritt 3: .env anlegen

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:

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

Schritt 4: Stack starten

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

sudo docker compose up -d --build

Oder offizielle Images ziehen:

CONTAINER_REGISTRY=ghcr.io/znuny/znuny-docker
ZNUNY_IMAGE_TAG=stable

sudo docker compose up -d

Release beim Build festlegen:

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:

sudo docker compose ps
sudo 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).

Schritt 5: Znuny öffnen

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.

HTTPS (Traefik) und externe Datenbank

# 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.

# 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.

Nach der Installation

Konsolenbefehle

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

Persistente Daten

Volume	Inhalt
ZnunyApp	Anwendungsdateien
ZnunyPersistent	Config.pm, Version, Restart-Trigger
MariaDBVol	Datenbankdateien

Vor Updates sichern — siehe Znuny Docker im Betrieb.

Firewall

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

Znuny aktualisieren

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.

Fehlerbehebung

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-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

Community-Stacks (Alternativen)

Nutzen Sie diese, wenn der offizielle Stack nicht passt.

Erik-Donath (Web-Installer)

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.

juanluisbaptiste (6.x LTS)

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

Nächste Schritte

• Znuny Docker im Betrieb — Konsole, Pakete, Backups
• Staging-System
• Znuny REST API
• Offizielle Installationsdoku
• znuny-docker README — Architektur, Env-Vars, CI

Häufig gestellte Fragen

Stellt Znuny einen offiziellen Docker-Compose-Stack bereit?

Ja. Seit 2026 veröffentlicht Znuny github.com/znuny/znuny-docker mit docker-compose.yml und Images auf ghcr.io. Der Stack gilt weiterhin als experimentell.

Brauche ich den Web-Installer beim offiziellen Stack?

Nein. install.sh konfiguriert die Datenbank beim ersten Start aus .env. Anmeldung mit ZNUNY_ADMIN_PASS. Community-Stacks wie Erik-Donath nutzen weiter installer.pl und den Datenbank-Host db.