Umgebungsvariablen

Nachfolgend finden Sie die wichtigsten Umgebungsvariablen mit Standardwerten, falls vorhanden. Die Variablen für Docker- und paketbasierte Installationen können in einigen Fällen unterschiedlich sein. In der Spalte Beschränkung finden Sie Icons mit der folgenden Bedeutung:

Nur für Docker-Installationen verfügbar:
Nur für Paketinstallationen verfügbar:
Verfügbar für beide Installationsvarianten: kein Icon

TIP

Wenn Sie eine .env-Datei in Docker Compose-Installationen verwenden möchten, können Sie die mitgelieferte .env.dist-Datei verwenden und sie als .env kopieren. Auf diese Weise wird sie von Docker Compose automatisch übernommen und bei Aktualisierungen nicht überschrieben.

Verschiedenes

Variable	Standardwert	Beschreibung
GPG_PATH	nicht gesetzt	Legt den Pfad der GPG-Installation fest. Nur benötigt wenn die PGP-Installation vom Standard abweicht oder Sie verschiedene PGP-Installationen verwenden wollen.
RAILS_LOG_TO_STDOUT	nicht gesetzt	Dies Einstellung kann während einem Update einer Paketinstallation überschrieben werden. Verwenden Sie `enabled` für eine Aktivierung bis zum nächsten Update. Verwenden Sie `true` für eine dauerhaft Aktivierung.
ZAMMAD_SAFE_MODE	nicht gesetzt	Seien Sie vorsichtig beim Ausführen von Befehlen im Safe-Mode in Produktivsystemen. Obwohl dieser Modus eine Rettung für manche Systeme sein kann, hat er auch das Potenzial, Systeme zu beschädigen.
ZAMMAD_BIND_IP	`127.0.0.1`	Die IP-Adresse, auf die Ihr Webserver lauscht.
S3_URL	nicht gesetzt	Erlaubt es, eine S3 Speicher-Konfiguration zu setzen. Beispiel für einen Wert: `https://key:secret@s3.eu-central-1.amazonaws.com/zammad-storage-bucket?region=eu-central-1&force_path_style=true`

Zammad

| -------------------------------------------------------- ----------------- | ------- | ---------------------------------------------------------- | ------------ ---------------------------------------------------------------------------------------------------- ---------------------------------------------------------------------------------------------------- ---------------------------------------------------------------------------------------------------- ---------------------------------------------------------------------------------------------------- ---------------------------------------------------------------------------------------------------- ------------------------------------------------- |

| VERSION | | Aktuelle stabile Version von Zammad | Ermöglicht die Anpassung des Zammad-Image-Tags. Beispiel: 6.3.1-54. Diese Standardversion kann erhöht werden, wenn Sie Ihren Zammad-Docker-Stack aktualisieren. Weitere Informationen zu dieser Variablen finden Sie in der Beispiel-Umgebungsvorlage. |

| AUTOWIZARD_JSON | | nicht gesetzt | Mit dieser Variablen können Sie die anfänglichen Konfigurationsdaten für Ihre Instanz bereitstellen. Autowizard JSON wird in dieser Dokumentation nicht behandelt, jedoch sollte diese Beispieldatei Ihnen weiterhelfen. |

| RAILS_TRUSTED_PROXIES | | 127.0.0.1,::1 | Diese Einstellung ist wichtig für die korrekte Erkennung von Client-IP-Adressen und darauf basierenden Funktionen wie der Ratenbegrenzung. Standardmäßig vertraut Zammad nur Localhost-Proxys. Alle zusätzlichen Proxy-Server müssen hier hinzugefügt werden, entweder über die IP-Adresse (wenn statisch) oder über den Hostnamen. Hostnamen werden beim Start von Zammad aufgelöst, sodass ein Neustart erforderlich ist, wenn sich die IP-Adresse eines Proxy-Servers ändert. Beachten Sie, dass Zammad im Docker-Kontext möglicherweise die IP-Adresse des Netzwerk-Gateways anstelle der tatsächlichen IP-Adresse des Proxy-Servers sieht, wenn dieser in einem anderen Netzwerk platziert ist. |

| ZAMMAD_PROCESS_DELAYED_
AI_JOBS_WORKERS | | unset | Wie viele Instanzen von AI-Workern gleichzeitig ausgeführt werden sollen. AI-Worker bearbeiten die AI-Anfragen von Zammad und holen die Antworten vom konfigurierten AI-Anbieter. Standardmäßig wird ein Worker ausgeführt. Selbst gehostete AI-Benutzer sollten bei der Erhöhung dieser Zahl vorsichtig sein, da Ihr AI-Dienst sonst zusammenbrechen könnte. Für Nutzer von KI-Cloud-Diensten mit einer großen Zammad-Instanz kann es sinnvoll sein, diese Zahl zu erhöhen, um eine gewisse Parallelisierung zu erreichen. Die maximale Anzahl von Arbeitern beträgt 16. |

| ZAMMAD_PROCESS_DELAYED_
AI_JOBS_WORKERS_
THREADS | | 5 | Wie viele Threads sollen von einem KI-Worker verarbeitet werden (wenn Sie mehr als einen Worker haben, wird dies mit der Anzahl der Worker multipliziert). Dies kann die KI-Verarbeitung beschleunigen, aber beachten Sie, dass ein Ruby-Worker ohnehin nur einen Kern umfassen kann. Die maximale Anzahl von Threads beträgt 16. |

| ZAMMAD_PROCESS_DELAYED_
COMMUNICATION_INBOUND_
JOBS_WORKERS | | nicht gesetzt | Ermöglicht das gleichzeitige Abrufen eingehender Kommunikationskanäle. Nützlich, wenn Sie viele Kanäle und/oder Postfächer hinzugefügt haben. 0 bedeutet, dass es im Hauptprozess ausgeführt wird, 1 bedeutet einen zusätzlichen Prozess usw. Die maximale Anzahl von Arbeitern ist 16. |

| ZAMMAD_PROCESS_DELAYED_
COMMUNICATION_INBOUND_
JOBS_WORKER_THREADS | | 1 | Threads, die zum Abrufen eingehender Kommunikationskanäle verwendet werden. Wie viele Threads sollten von Arbeitern für eingehende Jobs verwendet werden? Die maximale Anzahl an Threads beträgt 16. |

| MEMCACHE_SERVERS | | - Docker: zammad-memcached:11211
- Paket: nicht festgelegt | Stellen Sie Zammad Ihre eigene Memcached-Instanz zur Verfügung, wenn Sie bereits über eine verfügen. Der Fallback für die Paketinstallation ist /opt/zammad/tmp/cache*. |

| REDIS_URL | | - Docker: redis://zammad-redis:6379
- Paket: nicht festgelegt | Stellen Sie Ihre eigene Redis-Instanz bereit, wenn Sie bereits über eine verfügen. Der Fallback für die Paketinstallation ist /opt/zammad/tmp/websocket_*. Informationen zur Sentinel-Konfiguration finden Sie unter Redis-Variablen. |

Elasticsearch

Variable	Standardwert	Beschreibung
ELASTICSEARCH_ENABLED	`true`	Wenn Sie diese Variable auf false setzen, können Sie Ihr Zammad ohne Elasticsearch betreiben. Bitte beachten Sie, dass wir dringend davon abraten, dies zu tun.
ELASTICSEARCH_HOST	`zammad-elasticsearch`	Geben Sie einen Hostnamen oder eine Adresse für Ihre externes Elasticsearch-Cluster an.
ELASTICSEARCH_PORT	`9200`	Geben Sie bei Bedarf einen anderen Port für Elasticsearch an.
ELASTICSEARCH_SCHEMA	`http`	Standardmäßig ist Elasticsearch über HTTP erreichbar.
ELASTICSEARCH_NAMESPACE	`zammad`	Mit diesem Namensraum werden alle Zammad-bezogenen Indizes erstellt. Ändern Sie dies, wenn Sie externe Cluster verwenden.
ELASTICSEARCH_REINDEX	nicht gesetzt	Der Suchindex wird automatisch neu aufgebaut, wenn kein Index gefunden werden kann. Wenn Sie den Suchindex manuell neu aufbauen müssen, setzen Sie diese Variable entweder auf `true` oder führen Sie den Reindex-Befehl über Docker manuell aus.
ELASTICSEARCH_SSL_VERIFY	`true`	Erlaubt Ihnen, dass die Compose-Skripte bei Bedarf selbstsignierte SSL-Zertifikate für Ihre Elasticsearch-Installation ignorieren.
ELASTICSEARCH_HEAP_SIZE	`1G`	Legt den verfügbaren Speicher für Elasticsearch fest. Wenn Sie Probleme mit ES und seiner Leistung haben, sollten Sie diesen Wert auf eine angemessene Größe erhöhen.

PostgreSQL

Variable	Standardwert	Beschreibung
POSTGRESQL_HOST	`zammad-postgresql`	Hostname Ihres PostgreSQL-Servers. Verwenden Sie Ihren eigenen, wenn Sie bereits einen haben.
POSTGRESQL_PORT	`5432`	Stellen Sie den Port Ihres PostgreSQL-Servers ein.
POSTGRESQL_USER	`zammad`	Der Datenbank Benutzer für Zammad.
POSTGRESQL_PASS	`zammad`	Das Passwort des Datenbank-Benutzers von Zammad.
POSTGRESQL_DB	`zammad_production`	Zammads zu verwendende Datenbank.
POSTGRESQL_OPTIONS	`?pool=50`	Zusätzliche PostgreSQL-Parameter, die an den Datenbank-URI angehängt werden.
POSTGRESQL_DB_CREATE	`true`	Standardmäßig erstellt Zammad die erforderliche Datenbank. Auf bereits existierenden Datenbankservern kann die Voreinstellung problematisch sein.

Nginx

Variable	Standardwert	Beschreibung
NGINX_EXPOSE_PORT	`8080`	Der Port, der für den Zugriff auf den Zammad-Stack von außen freigegeben werden soll. Ändern Sie diesen Wert, wenn Sie bereits einen bestehenden Dienst haben, der auf diesen Port hört.
NGINX_PORT	`8080`	Der interne Port, an dem der Nginx-Dienst lauschen wird.
NGINX_SERVER_NAME	`_`	Standardmäßig wird der Nginx-Container von Zammad auf alle Anfragen antworten. Sie können Ihre IP / FQDN angeben, wenn Sie das möchten.
NGINX_SERVER_SCHEME	`\$scheme`	Wenn der Nginx-Container für Zammad nicht der Upstream-Server ist (d.h. Sie verwenden einen anderen Proxy vor Nginx), kann `$scheme` falsch sein. Sie können das korrekte Schema `http` oder `https` einstellen, falls nötig.
NGINX_CLIENT_MAX_BODY_SIZE	nicht gesetzt	Definieren Sie die maximale Größe der Daten, die ein Client an den Server senden kann.
ZAMMAD_RAILSSERVER_HOST	`zammad-railsserver`	Hostname des Rails-Server-Containers.
ZAMMAD_RAILSSERVER_PORT	`3000`	Port des Rails-Servers von Zammad.
ZAMMAD_RAILS_PORT	`3000`	Port des Rails-Servers von Zammad.
ZAMMAD_WEBSOCKET_HOST	`zammad-websocket`	Hostname des Websocket-Servers von Zammad.
ZAMMAD_WEBSOCKET_PORT	`6042`	Port des Websocket-Servers von Zammad.

Leistungsoptimierung

Jede der unten aufgeführten Einstellungen bringt ihre eigenen Kompromisse mit sich. Es gibt hier keine empfohlenen Werte; die optimale Konfiguration hängt von den Ressourcen Ihres Systems und der typischen Anwendungslast ab.

Gehen Sie mit Vorsicht vor. Wenn Sie eine dieser Einstellungen anpassen, gibt es einen Punkt, an dem sich die Leistung eher verschlechtert als verbessert, oder andere Probleme auftreten.

Die nachstehenden Einstellungen können alle verfügbaren Datenbank-Verbindungen verwenden. Bitte beachten Sie die Datenbankserver-Konfiguration für weitere Informationen.

Variable	Standardwert	Beschreibung
ZAMMAD_WEB_CONCURRENCY	nicht gesetzt	Erlaubt das Erstellen von `n` Workern, um mehr gleichzeitige Verbindungen für Zammads Web-UI zu ermöglichen. Falls Sie Hardware-Begrenzungen für Docker angewendet haben, sollte die CPU-Einstellung des Zammad-Railsservers mit dem Wert dieser Variable übereinstimmen.
ZAMMAD_PROCESS_SESSION_ JOBS_WORKERS	nicht gesetzt	Wie viele Instanzen des Session Workers gleichzeitig laufen sollen. Das Erhöhen dieses Wertes kann Hintergrundaufgaben (wie die Automatisierung) beschleunigen, wenn viele Benutzer gleichzeitig auf Zammad sind. Es ist jedoch nicht sinnvoll, diese Einstellung zu ändern, wenn Sie weniger als 40 gleichzeitig aktive Benutzer haben. Das Erhöhen der Anzahl der Worker kann eine Menge Ressourcen verbrauchen! Falls Sie Hardware-Begrenzungen für Docker angewendet haben, sollte die CPU-Einstellung des Zammad-Schedulers der Summe aller Variablen der Worker-Einstellungen entsprechen.
ZAMMAD_PROCESS_SCHEDULED_ JOBS_WORKERS	nicht gesetzt	Erlaubt das Erstellen von `1` unabhängigem Worker für geplante Aufgaben, um Zammads Hintergrundworker zu entlasten. Maximale Anzahl von Workern: `1`. Falls Sie Hardware-Begrenzungen für Docker angewendet haben, sollte die Zammad-Scheduler CPU-Einstellung der Summe aller Worker-Einstellungen entsprechen.
ZAMMAD_PROCESS_DELAYED_ JOBS_WORKERS	nicht gesetzt	Erlaubt das Erstellen von `n` Delayed-Jobs Workern, um den Druck von Zammads Hintergrundworker zu nehmen. Falls Sie Hardware-Begrenzungen für Docker angewendet haben, sollte die Zammad-Scheduler CPU-Einstellung der Summe aller Worker-Einstellungen entsprechen.