Environment variables

Trova di seguito le variabili d’ambiente più importanti con i valori predefiniti (come badge), se applicabile. Le variabili per le installazioni basate su Docker e pacchetti possono essere diverse in alcuni casi. Puoi trovare un altro badge aggiunto ai nomi delle variabili con il seguente significato:

• Disponibile solo per installazioni Docker:
• Disponibile solo per installazioni tramite pacchetto:
• Disponibile per entrambe le varianti di installazione: senza badge

TIP

Se vuoi usare un file .env nelle distribuzioni Docker Compose, puoi usare quello fornito.

Varie

GPG_PATH

Definisce il percorso della tua installazione GPG. Necessario solo se vuoi usarla.

RAILS_LOG_TO_STDOUT

Questa impostazione può essere sovrascritta durante l'aggiornamento sulle installazioni tramite pacchetto.

ZAMMAD_SAFE_MODE

Fai attenzione quando esegui comandi Zammad su sistemi di produzione.

ZAMMAD_BIND_IP 127.0.0.1

The IP address that the web server is bound to.

S3_URL

Ti permette di fornire la configurazione del tuo provider di storage S3. Esempio per.

Zammad

VERSION current stable version of Zammad

Allows customization of the Zammad image tag. Example: 6.3.1-54. This default version may be increased when you update your Zammad Docker stack. Please see the example env file for more details on this variable.

AUTOWIZARD_JSON

This variable allows you to provide initial configuration data for your instance. Autowizard JSON is out of scope of this documentation, however this example file should help.

ZAMMAD_HTTP_TYPE

Set the http type for your instance. Possible values are http and https.

ZAMMAD_FQDN

Set the FQDN for your instance.

RAILS_TRUSTED_PROXIES 127.0.0.1,::1

Questa impostazione è importante.

Per impostazione predefinita, Zammad si fida solo dei proxy localhost. Eventuali server proxy aggiuntivi devono essere aggiunti.

Nota che nel contesto Docker, Zammad potrebbe vedere l'indirizzo IP del gateway di rete invece di.

ZAMMAD_MANAGE_SESSIONS_JOBS_WORKERS 0

Permette di forkare il worker.

ZAMMAD_PROCESS_DELAYED_AI_JOBS_WORKERS 0

Tale worker gestisce.

Gli utenti AI self-hosted dovrebbero fare attenzione ad aumentarlo, il tuo servizio AI potrebbe collassare.

ZAMMAD_PROCESS_DELAYED_AI_JOBS_WORKERS_THREADS 5

Quanti.

ZAMMAD_PROCESS_DELAYED_COMMUNICATION_INBOUND_JOBS_WORKERS 0

ZAMMAD_PROCESS_DELAYED_COMMUNICATION_INBOUND_JOBS_WORKER_THREADS <Badge type="tip" text=

MEMCACHE_SERVERS Docker: zammad-memcached:11211 <Badge type=

REDIS_URL Docker: redis://zammad-redis:6379 Package: unset

Fornisci una tua istanza Redis se ne hai già una. Il fallback dell’installazione tramite pacchetto è /opt/zammad/tmp/websocket_*. Consulta Variabili Redis per una configurazione con Sentinel.

LD_PRELOAD libjemalloc.so.2

Preloads a shared library for all Zammad processes. Package installations use it to enable jemalloc as memory allocator and set it automatically if the library is present on your system. This variable is managed by the package install script and may be overwritten during updates.

ZAMMAD_USE_JEMALLOC

Set to no to opt out of jemalloc as memory allocator. Takes effect on the next package installation or upgrade. Unset it to opt back in; any value other than no re-enables jemalloc on the next package installation or upgrade.

Elasticsearch

ELASTICSEARCH_ENABLED true

Impostare questa variabile su.

ELASTICSEARCH_HOST zammad-elasticsearch

Provide a host name or address to your external Elasticsearch cluster.

ELASTICSEARCH_PORT 9200

Provide a different port for Elasticsearch if needed.

ELASTICSEARCH_SCHEMA http

Change it to https if your Elasticsearch cluster is configured to use SSL.

ELASTICSEARCH_NAMESPACE zammad

With this name space all Zammad related indexes will be created. Change this if you're using external clusters.

ELASTICSEARCH_REINDEX

L'indice di ricerca viene ricostruito automaticamente quando nessun indice.

ELASTICSEARCH_SSL_VERIFY true

Ti permette di far.

ELASTICSEARCH_HEAP_SIZE 1G

Imposta la memoria disponibile.

PostgreSQL

TIP

Le variabili per l'installazione Docker e tramite pacchetto sono parzialmente diverse. Controlla le limitazioni.

POSTGRESQL_HOST zammad-postgresql

Nome host o indirizzo IP.

POSTGRESQL_PORT 5432

Adjust the port of your PostgreSQL server.

POSTGRESQL_USER zammad

The database user for Zammad.

POSTGRESQL_PASS zammad

The password of Zammad's database user.

POSTGRESQL_DB zammad_production

Zammad's database to use.

POSTGRES_HOST zammad-postgresql

Host name or IP address of your PostgreSQL server. In case you use an IPv6 address, enclose the address in square brackets (e.g. [2001:db8::2]).

POSTGRES_PORT 5432

Adjust the port of your PostgreSQL server.

POSTGRES_USER zammad

The database user for Zammad.

POSTGRES_PASS zammad

The password of Zammad's database user.

POSTGRES_DB zammad_production

Zammad's database to use.

POSTGRESQL_OPTIONS ?pool=50

Additional PostgreSQL params to be appended to the database URI.

POSTGRESQL_DB_CREATE true

Per impostazione predefinita, Zammad crea il database necessario. Su server di database già esistenti, il valore predefinito potrebbe causare problemi.

Nginx

NGINX_EXPOSE_PORT 8080

La porta da esporre per l'accesso.

NGINX_PORT 8080

The internal port the Nginx service will listen on.

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.

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. Set this if you face a CSRF Token Verification Failed error.

NGINX_CLIENT_MAX_BODY_SIZE

Define the maximum size of data that a client can send to the server.

ZAMMAD_RAILSSERVER_HOST zammad-railsserver

Host name of the Rails server container.

ZAMMAD_RAILSSERVER_PORT 3000

Port of Zammad's Rails server.

ZAMMAD_RAILS_PORT 3000

Port of Zammad's Rails server.

ZAMMAD_WEBSOCKET_HOST zammad-websocket

Host name of Zammad's WebSocket server.

ZAMMAD_WEBSOCKET_PORT 6042

Port of Zammad's WebSocket server.

Performance tuning

Ognuna delle impostazioni seguenti comporta dei compromessi. Non ci sono valori consigliati qui.

Procedi con cautela; quando regoli una di queste impostazioni, c'è un punto in cui le prestazioni.

Le impostazioni riportate di seguito possono consumare tutte le connessioni disponibili del database. Considera la sezione Configure Database Server per maggiori informazioni.

ZAMMAD_WEB_CONCURRENCY

Consente di avviare n worker per permettere più connessioni simultanee all’interfaccia web di Zammad. Nel caso tu abbia applicato limiti alle risorse hardware di Docker, l’impostazione della CPU del servizio zammad-railsserver dovrebbe corrispondere al valore di questa variabile.

ZAMMAD_PROCESS_SESSION_JOBS_WORKERS

Quanti processi del worker di sessione eseguire.

Nel caso tu abbia applicato limiti alle risorse hardware di Docker, l’impostazione della CPU del servizio zammad-scheduler dovrebbe corrispondere alla somma di tutte le variabili di impostazione dei worker.

ZAMMAD_PROCESS_SCHEDULED_JOBS_WORKERS

Permette di generare 1 worker indipendente per i job pianificati.

Nel caso tu abbia applicato limiti alle risorse hardware di Docker, l’impostazione della CPU del servizio zammad-scheduler dovrebbe corrispondere alla somma di tutte le variabili di impostazione dei worker.

ZAMMAD_PROCESS_DELAYED_JOBS_WORKERS

Permette di generare n processi worker per rilasciare.

Nel caso tu abbia applicato limiti alle risorse hardware di Docker, l’impostazione della CPU del servizio zammad-scheduler dovrebbe corrispondere alla somma di tutte le variabili di impostazione dei worker.

ZAMMAD_PROCESS_DELAYED_JOBS_WORKER_THREADS

Thread usati da un worker dei job ritardati.

HTTP client settings

Impostazioni globali di timeout HTTP. Queste variabili controllano il comportamento di timeout predefinito.

ZAMMAD_HTTP_OPEN_TIMEOUT 30

Definisce il tempo massimo in secondi.

ZAMMAD_HTTP_READ_TIMEOUT 60

Definisce il tempo massimo in secondi.

ZAMMAD_HTTP_TOTAL_TIMEOUT 60

Defines the maximum total time in seconds for the complete HTTP request, wrapping connection establishment and response read. This is an additional hard ceiling on top of ZAMMAD_HTTP_OPEN_TIMEOUT and ZAMMAD_HTTP_READ_TIMEOUT.

How to set environment variables

Dipende da come hai installato Zammad (pacchetto, Docker). Impostala tramite zammad config.

Esempi per installazioni tramite pacchetto:

Imposta OPZIONE a "valore":

zammad config:set OPTION=value

Ottieni OPZIONE:

zammad config:get OPTION

Rimuovi OPZIONE:

zammad config:unset OPTION

Riavvia Zammad dopo aver modificato le impostazioni:

sudo systemctl restart zammad