Skip to content

Commit

Permalink
Maintenance: adjusted docker table and fixed typo
Browse files Browse the repository at this point in the history
* Maintenance: adjusted column width / fixed typo
Co-authored by: @sangramrath
  • Loading branch information
ralf401 committed Aug 21, 2023
1 parent 1e731be commit 23b3ec8
Showing 1 changed file with 39 additions and 36 deletions.
75 changes: 39 additions & 36 deletions install/docker-compose/environment.rst
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@
Docker Compose Environment Variables
************************************

Zammad's Docker Compose supports several environment variables that are not
Zammad's Docker Compose supports several environment variables that are not
set by default. The best way to provide these is within the file ``.env``.

In case our default ``docker-compose.yml`` is not good enough, please use
``docker-compose.override.yml`` to provide own changes.

.. note::

Unless stated other wise, below environment variables count for the whole
Unless stated otherwise, below environment variables count for the whole
Zammad stack and not single containers. Below grouping is to help you find
them better, but do not reflect their container.

Docker Compose
--------------
.. list-table::
:widths: 20 25 30 25
.. list-table::
:widths: 28 20 26 26
:header-rows: 1

* - Variable
Expand All @@ -26,16 +26,16 @@ Docker Compose
* - RESTART
- ``always``
- By default containers will be restarted in case they stopped for whatever reason.
-
-
* - VERSION
-
-
- This variables contains the version tag. Example: ``3.6.0-20``
- We update this string from time to time, Docker Hub may contain more current tags to the moment you're pulling.

Zammad
------
.. list-table::
:widths: 20 25 30 25
.. list-table::
:widths: 28 20 26 26
:header-rows: 1

* - Variable
Expand All @@ -50,32 +50,35 @@ Zammad
- ``(unset)``
- Allows spawning ``n`` workers to allow more simultaneous connections for Zammads web UI. Please also note :doc:`/appendix/configure-env-vars` in this regard.
- .. tip:: This variable is specific to the ``railsserver`` container.
* - ZAMMAD_SESSION_JOBS_CONCURRENT
* - | ZAMMAD_SESSION_JOBS
| _CONCURRENT
- ``(unset)``
- Allows spawning ``n`` session job workers to release pressure from Zammads background worker. Please also note :doc:`/appendix/configure-env-vars` in this regard.
- .. include:: /install/docker-compose/scheduler-specific.include.rst
* - ZAMMAD_PROCESS_SCHEDULED_JOBS_WORKERS
* - | ZAMMAD_PROCESS_SCHEDULED
| _JOBS_WORKERS
- ``(unset)``
- Allows spawning ``1`` independent scheduled job worker to release pressure from Zammads background worker. Please also note :doc:`/appendix/configure-env-vars` in this regard.
- .. Tip:: This variable is specific to the ``scheduler`` container.
* - ZAMMAD_PROCESS_DELAYED_JOBS_WORKERS
* - | ZAMMAD_PROCESS_DELAYED
| _JOBS_WORKERS
- ``(unset)``
- Allows spawning ``n`` delayed job workers to release pressure from Zammads background worker. Please also note :doc:`/appendix/configure-env-vars` in this regard.
- .. Tip:: This variable is specific to the ``scheduler`` container.
* - RAILS_TRUSTED_PROXIES
- ``['127.0.0.1', '::1']``
- By default Zammad trusts localhost proxies only.
- .. Tip:: This variable is specific to the ``init`` container.
- By default Zammad trusts localhost proxies only.
- .. Tip:: This variable is specific to the ``init`` container.
.. danger:: **⚠ Only change this option if you know what you're doing! ⚠**

.. _this example file:
https://github.com/zammad/zammad/blob/stable/contrib/auto_wizard_example.json


Elasticsearch
-------------
.. list-table::
:widths: 20 25 30 25
.. list-table::
:widths: 28 20 26 26
:header-rows: 1

* - Variable
Expand All @@ -97,7 +100,7 @@ Elasticsearch
* - ELASTICSEARCH_SCHEMA
- ``http``
- By default Elasticsearch is reachable via HTTP.
- .. include:: /install/docker-compose/init-specific.include.rst
- .. include:: /install/docker-compose/init-specific.include.rst
* - ELASTICSEARCH_NAMESPACE
- ``zammad``
- With this name space all Zammad related indexes will be created. Change this if you're using external clusters.
Expand All @@ -114,8 +117,8 @@ Elasticsearch

Memcached
---------
.. list-table::
:widths: 20 25 30 25
.. list-table::
:widths: 28 20 26 26
:header-rows: 1

* - Variable
Expand All @@ -129,8 +132,8 @@ Memcached

Redis
-----
.. list-table::
:widths: 20 25 30 25
.. list-table::
:widths: 28 20 26 26
:header-rows: 1

* - Variable
Expand All @@ -144,8 +147,8 @@ Redis

NGINX
-----
.. list-table::
:widths: 20 25 30 25
.. list-table::
:widths: 28 20 26 26
:header-rows: 1

* - Variable
Expand All @@ -155,27 +158,27 @@ NGINX
* - NGINX_PORT
- ``8080``
- The port Nginx will listen on.
- .. include:: /install/docker-compose/nginx-specific.include.rst
- .. include:: /install/docker-compose/nginx-specific.include.rst
* - NGINX_SERVER_NAME
- ``_``
- By default the Nginx container of Zammad will respond to all request. You can provide your IP / FQDN if you want to.
- .. include:: /install/docker-compose/nginx-specific.include.rst
- .. include:: /install/docker-compose/nginx-specific.include.rst
* - NGINX_SERVER_SCHEME
- ``\$scheme``
- If the Nginx container for Zammad **is not** the upstream server (aka you're using another proxy in front of nginx) ``$scheme`` may be wrong. You can set the correct scheme ``http`` or ``https`` if needed.
- .. include:: /install/docker-compose/nginx-specific.include.rst
- .. include:: /install/docker-compose/nginx-specific.include.rst
* - ZAMMAD_RAILSSERVER_HOST
- ``zammad-railsserver``
- Host name of the rails server container.
- Host name of the rails server container.
-
* - ZAMMAD_RAILSSERVER_PORT
- ``3000``
- Port of Zammads rails server.
- Port of Zammads rails server.
- .. include:: /install/docker-compose/include-env-var-note.rst
* - ZAMMAD_WEBSOCKET_HOST
- ``zammad-websocket``
- Host name of Zammads websocket server.
- .. include:: /install/docker-compose/nginx-specific.include.rst
- .. include:: /install/docker-compose/nginx-specific.include.rst
* - ZAMMAD_WEBSOCKET_PORT
- ``6042``
- Port of Zammads websocket server.
Expand All @@ -185,8 +188,8 @@ NGINX

PostgreSQL
----------
.. list-table::
:widths: 20 25 30 25
.. list-table::
:widths: 28 20 26 26
:header-rows: 1

* - Variable
Expand All @@ -196,11 +199,11 @@ PostgreSQL
* - POSTGRESQL_HOST
- ``zammad-postgresql``
- Host name of your PostgreSQL server. Use your own if you already have one.
-
-
* - POSTGRESQL_PORT
- ``5432``
- Adjust the Port of your PostgreSQL server.
-
-
* - POSTGRESQL_USER
- ``zammad``
- The database user for Zammad.
Expand All @@ -215,10 +218,10 @@ PostgreSQL
-
* - POSTGRESQL_DB_CREATE
- ``true``
- By default we will create the required database.
- By default we will create the required database.
- .. note:: On own database servers this setting might be troublesome.
.. include:: /install/docker-compose/init-specific.include.rst
.. include:: /install/docker-compose/init-specific.include.rst
* - RSYNC_ADDITIONAL_PARAMS
- ``--no-perms --no-owner``
- By default the compose will copy data without permissions and owners. This may not fit for your storage driver.
- .. include:: /install/docker-compose/init-specific.include.rst
- .. include:: /install/docker-compose/init-specific.include.rst

0 comments on commit 23b3ec8

Please sign in to comment.