From 199e765054ae372eb10ba5914b5d66eba9d37ae4 Mon Sep 17 00:00:00 2001 From: Ralf Schmid Date: Thu, 18 Dec 2025 17:10:19 +0100 Subject: [PATCH 1/3] First iteration --- appendix/environment-variables.rst | 38 +++++++++++++++++++++--------- 1 file changed, 27 insertions(+), 11 deletions(-) diff --git a/appendix/environment-variables.rst b/appendix/environment-variables.rst index 2011a1d6..0efcc6c8 100644 --- a/appendix/environment-variables.rst +++ b/appendix/environment-variables.rst @@ -87,16 +87,16 @@ Zammad `this example file `_ should help. * - ZAMMAD_HTTP_TYPE - - + - - unset - Set the :admin-docs:`http type ` for your instance. Possible values are ``http`` and ``https``. * - ZAMMAD_FQDN - - + - - unset - Set the :admin-docs:`FQDN ` for your instance. * - RAILS_TRUSTED_PROXIES - - + - - ``127.0.0.1,::1`` - This setting is important for the correct detection of client IP addresses and features based on it, like rate limiting. @@ -111,7 +111,7 @@ Zammad another network. * - | ZAMMAD_PROCESS_DELAYED\_ | AI_JOBS_WORKERS - - + - - unset - How many instances of AI workers to run simultaneously. AI workers handle Zammad's AI requests and fetch the responses from the configured AI @@ -122,20 +122,36 @@ Zammad The maximum number of workers is ``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. The maximum number of threads is ``16``. + * - | ZAMMAD_PROCESS_DELAYED\_ + | COMMUNICATION_INBOUND\_ + | JOBS_WORKERS + - + - unset + - Allows parallelization of channel fetching. Useful if you have many + channels and/or mailboxes added. ``0`` means it done in one process, + ``1`` means one additional process, etc. The maximum number of workers is + ``16``. + * - | ZAMMAD_PROCESS_DELAYED\_ + | COMMUNICATION_INBOUND\_ + | JOBS_WORKER_THREADS + - + - ``1`` + - How many threads should be used by inbound jobs workers. The maximum + number of threads is ``16``. * - MEMCACHE_SERVERS - - + - - - Docker: ``zammad-memcached:11211`` - Package: unset - Provide your own Memcached instance to Zammad if you already have one. The package installation fallback is ``/opt/zammad/tmp/cache*``. * - REDIS_URL - - + - - - Docker: ``redis://zammad-redis:6379`` - Package: unset - Provide your own Redis instance if you already have one. @@ -315,7 +331,7 @@ the :doc:`configure-database-server` for more information. - Default Value - Description * - ZAMMAD_WEB_CONCURRENCY - - + - - unset - Allows spawning ``n`` workers to allow more simultaneous connections for Zammad's web UI. @@ -323,7 +339,7 @@ the :doc:`configure-database-server` for more information. the zammad-railsserver's CPU setting should match the value from this variable. * - | ZAMMAD_PROCESS\_ | SESSION_JOBS_WORKERS - - + - - unset - How many instances of the session worker to run at a time. Increasing this value can speed up background jobs (like the scheduler) when many @@ -336,7 +352,7 @@ the :doc:`configure-database-server` for more information. settings variables. * - | ZAMMAD_PROCESS\_ | SCHEDULED_JOBS_WORKERS - - + - - unset - Allows spawning ``1`` independent scheduled jobs worker to release pressure from Zammad's background worker. Maximum number of workers: @@ -347,7 +363,7 @@ the :doc:`configure-database-server` for more information. settings variables. * - | ZAMMAD_PROCESS\_ | DELAYED_JOBS_WORKERS - - + - - unset - Allows spawning ``n`` delayed jobs workers to release pressure from Zammad's background worker. From 52f476fb24915a2acc3538ebae58af78a3586409 Mon Sep 17 00:00:00 2001 From: Ralf Schmid Date: Fri, 19 Dec 2025 08:01:10 +0100 Subject: [PATCH 2/3] Add inbound communication workers/threads to env. variables --- appendix/environment-variables.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/appendix/environment-variables.rst b/appendix/environment-variables.rst index 0efcc6c8..2f1d03b9 100644 --- a/appendix/environment-variables.rst +++ b/appendix/environment-variables.rst @@ -133,16 +133,17 @@ Zammad | JOBS_WORKERS - - unset - - Allows parallelization of channel fetching. Useful if you have many - channels and/or mailboxes added. ``0`` means it done in one process, - ``1`` means one additional process, etc. The maximum number of workers is - ``16``. + - Allows parallelization of fetching inbound communication channels. + Useful if you have many channels and/or mailboxes added. ``0`` means it + runs in the main process, ``1`` means one additional process, etc. The + maximum number of workers is ``16``. * - | ZAMMAD_PROCESS_DELAYED\_ | COMMUNICATION_INBOUND\_ | JOBS_WORKER_THREADS - - ``1`` - - How many threads should be used by inbound jobs workers. The maximum + - Threads used for fetching inbound communication channels. How many + threads should be used by inbound jobs workers. The maximum number of threads is ``16``. * - MEMCACHE_SERVERS - From 643bccb9f68ff2af17850c3cda6045081319efcf Mon Sep 17 00:00:00 2001 From: Ralf Schmid Date: Fri, 19 Dec 2025 08:03:02 +0100 Subject: [PATCH 3/3] Changed parallelization to concurrent --- appendix/environment-variables.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/appendix/environment-variables.rst b/appendix/environment-variables.rst index 2f1d03b9..1b15a276 100644 --- a/appendix/environment-variables.rst +++ b/appendix/environment-variables.rst @@ -133,7 +133,7 @@ Zammad | JOBS_WORKERS - - unset - - Allows parallelization of fetching inbound communication channels. + - Allows concurrent fetching of inbound communication channels. Useful if you have many channels and/or mailboxes added. ``0`` means it runs in the main process, ``1`` means one additional process, etc. The maximum number of workers is ``16``.