Konfiguration über Umgebungsvariablen

Verwenden Sie diese Umgebungsvariablen, um das Verhalten von Zammad zur Laufzeit zu konfigurieren. Sie sollten auch einen Blick auf die Sammlung von Rails-Befehlen werfen.

WARNING

Bitte beachten Sie, dass die Umgebungsvariablen für Installationen auf Basis von Docker und Kubernetes unterschiedlich benannt sein können.

Standardwerte sind mit einem badge gekennzeichnet, sofern vorhanden.

Allgemeine Optionen

GPG_PATH

Legt den Pfad zur GPG-Installation fest. Dies wird nur benötigt, wenn Sie Zammad aus dem Quellcode installiert haben, wenn Sie verschiedene Versionen von PGP auf Ihrem Rechner verwenden wollen oder wenn Ihre PGP-Installation von der Standard-Installation abweicht.

RAILS_LOG_TO_STDOUT

Ausgabe direkt auf Standard Output anstatt in /var/log/zammad/production.log.

Diese Einstellung kann bei der Aktualisierung von Paket-Installationen überschrieben werden. Verwenden Sie enabled, um diese Option nur bis zur nächsten Aktualisierung einzuschalten. Verwenden Sie true, um sie dauerhaft einzuschalten.

ZAMMAD_SAFE_MODE`

Ignoriert die Verfügbarkeit von Third-Party-Diensten bei der Ausführung von Zammad- Befehlen. Mögliche Werte: 1 oder true

WARNING

Vorsicht bei der Ausführung von Zammad-Befehlen auf Produktivsystemen im abgesicherten Modus.

Dies kann zwar einen Ausweg für bestimmte Fälle bieten, hat aber das Potenzial, reguläre Zammad-Vorgänge zu unterbrechen.

ZAMMAD_HTTP_TYPE

Bestimmt das HTTP-Protokoll Ihrer Instanz. Mögliche Werte: http oder https

ZAMMAD_FQDN: Legt den FQDN/Domainnamen des Systems fest.

Netzwerk-Optionen

TIP

Denken Sie daran, Ihre Webserverkonfiguration zu aktualisieren, damit alle Änderungen, die Sie hier vorgenommen haben, wirksam werden.

ZAMMAD_BIND_IP 127.0.0.1

Die IP-Adresse, an die der Webserver gebunden ist.

ZAMMAD_RAILS_PORT 3000

Der Port, auf dem der Webserver erreichbar ist.

ZAMMAD_WEBSOCKET_PORT 6042

Der Port, auf dem der Web-Socket-Server betrieben wird.

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.

Die folgenden Einstellungen können alle verfügbaren Datenbankverbindungen beanspruchen. Bitte prüfen Sie die Konfiguration Ihres Datenbankservers.

DANGER

Seien Sie vorsichtig und verwenden Sie die Einstellungen nur, wenn Sie wissen, was Sie tun! Die folgenden Einstellungen können zu einer sehr hohen Systemauslastung führen und/oder relevante Teile von Zammad deaktivieren.

Um herauszufinden, wie viele Benutzer derzeit auf Zammad sind, können Sie den folgenden Rails-Befehl verwenden:

zammad run rails r "p Sessions.list.uniq.count"

WEB_CONCURRENCY

Wie viele Instanzen des Anwendungsservers gleichzeitig offen sein sollen. Eine Erhöhung kann die Ladezeiten verringern, wenn zu viele Benutzer gleichzeitig auf Zammad sind.

ZAMMAD_PROCESS_SESSION_JOBS_WORKERS : How many instances of the session worker to run at a time.

Increasing this can speed up background jobs (like the scheduler) when many users are on Zammad at once.

It is not useful to adjust this setting if you have less than 40 active users at a time. Increasing the amount of workers can consume a lot of resources!

ZAMMAD_PROCESS_SCHEDULED_JOBS_WORKERS

Allows spawning an independent process just for processing scheduled jobs like LDAP syncs. This can free up Zammad's background worker for other tasks when running tasks that take rather long.

Maximale Anzahl von Workern: 1

Sie können die Verarbeitung von geplanten Aufgaben deaktivieren, indem Sie ZAMMAD_PROCESS_SCHEDULED_JOBS_DISABLE deaktivieren (nicht empfohlen!).

ZAMMAD_PROCESS_DELAYED_JOBS_WORKERS

How many processes should work on delayed jobs? Increasing this can improve issues with delayed jobs stacking up in your system. You may want to try to use ZAMMAD_SESSION_JOBS_CONCURRENT before though.

Maximale Anzahl von Workern: 16

ZAMMAD_PROCESS_DELAYED_AI_JOBS_WORKERS

How many instances of AI workers should run simultaneously. AI workers handle Zammad's AI requests and fetch the responses from the configured AI provider. By default, one worker is running.

Self hosted AI users should be careful in increasing it. Depending on your hardware, it may cause your AI service to collapse.

For AI cloud service users with a big Zammad instance, it could make sense to increase it to have some kind of parallelization.

Maximale Anzahl von Workern: 16

ZAMMAD_PROCESS_DELAYED_AI_JOBS_WORKERS_THREADS 5

How many threads should be processed by one AI worker (if you have more than one worker, it is multiplied by the amount of workers). This may speed up the AI processing, but be aware that a ruby worker can only span across 1 core anyway.

Maximum number of threads: 16

Zusätzliche Performance-Anpassungen

INFO

Mit den unten aufgeführten Optionen können Sie die Zammad-Prozesse über mehrere Anwendungsknoten zu verteilen. Auch wenn das nicht Ihr Ziel ist, können sie bei größeren Installationen von großem Nutzen sein.

Bitte beachten Sie, dass die Verteilung von Prozessen auf mehrere Knoten nicht Inhalt dieser Dokumentation ist.

REDIS_URL

Speichern Sie Ihre Web-Socket-Verbindungsinformationen in Redis. Dazu teilen Sie Zammad mit, wo Ihre Redis-Instanz zu finden ist: redis://Ihr.redis.server:6379 Falls nicht angegeben, greift Zammad auf das Dateisystem zurück (/opt/zammad/tmp/websocket_*) zurück.

MEMCACHE_SERVERS

Speichern Sie Ihre Anwendungs-Cache-Dateien in Memcached. Dazu teilen Sie Zammad mit, wo Ihre Memcached-Instanz zu finden ist: Ihr.memcached.server:11211 Wenn nicht angegeben, greift Zammad auf das Dateisystem zurück (/opt/zammad/tmp/cache*) zurück.

Mit Memcached können Sie die maximale Größe festlegen, die Zammad als Cache speichern kann. Dies ist sehr nützlich für die Leistung und um die Cache-Dateien klein zu halten. 1 GB sollte eine angemessene Größe sein.

Speicheroptionen

S3_URL: Hier können Sie Ihre S3-Konfiguration angeben.

Format / Beispiel:

https://key:secret@s3.eu-central-1.amazonaws.com/zammad-storage-bucket?region=eu-central-1&force_path_style=true