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

L'indirizzo IP a cui il web server si collega.

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 : Imposta il tipo http per la tua istanza. I valori possibili sono http e `

ZAMMAD_FQDN : Imposta l'FQDN per la tua istanza.

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.

Elasticsearch

ELASTICSEARCH_ENABLED true

Impostare questa variabile su.

ELASTICSEARCH_HOST zammad-elasticsearch

Fornisci un host.

ELASTICSEARCH_PORT 9200

Fornisci una porta diversa per.

ELASTICSEARCH_SCHEMA http

Cambialo in https se.

ELASTICSEARCH_NAMESPACE zammad

Con questo namespace.

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

Regola la porta del tuo PostgreSQL.

POSTGRESQL_USER zammad

L'utente database per Zammad.

POSTGRESQL_PASS zammad

La password del database di Zammad.

POSTGRESQL_DB zammad_production

Il database di Zammad da.

POSTGRES_HOST zammad-postgresql

Nome host o indirizzo IP.

POSTGRES_PORT 5432

Regola la porta del tuo PostgreSQL.

POSTGRES_USER zammad

L'utente database per Zammad.

POSTGRES_PASS zammad

La password del database di Zammad.

POSTGRES_DB zammad_production

Il database di Zammad da usare.

POSTGRESQL_OPTIONS ?pool=50

Parametri PostgreSQL aggiuntivi da.

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

La porta interna che il servizio Nginx usa.

NGINX_SERVER_NAME _

Per impostazione predefinita, il container Nginx.

NGINX_SERVER_SCHEME \$scheme

Se il container Nginx.

NGINX_CLIENT_MAX_BODY_SIZE : Definisce la dimensione massima dei dati che un client può inviare.

ZAMMAD_RAILSSERVER_HOST zammad-railsserver

Nome host.

ZAMMAD_RAILSSERVER_PORT 3000

Porta del server Rails di Zammad.

ZAMMAD_RAILS_PORT 3000

Porta del server Rails di Zammad.

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