Ezx DeskДокументация v4.12.2
Документация › Начало работы › Файл настроек

Файл настроек

Все настройки сервера задаются в файле ezxdesk.toml. Любой параметр можно переопределить переменной окружения: [mail] poll_interval → EZX_MAIL_POLL_INTERVAL.

Минимальный файл

[server]
public_url = "https://desk.example.com"
listen = "0.0.0.0:8080"

[database]
url = "postgres://ezxdesk:${DB_PASSWORD}@db:5432/ezxdesk"
pool_size = 20

[files]
storage = "local"            # local | s3
path = "/var/lib/ezxdesk/files"

[mail]
poll_interval = "60s"

Раздел [server]

ПараметрПо умолчаниюОписание
public_url—Адрес, по которому система открывается у пользователей. Используется в письмах и ссылках.
listen127.0.0.1:8080Адрес и порт HTTP-сервера.
trusted_proxies["127.0.0.1"]Адреса прокси, которым можно верить в заголовке X-Forwarded-For.
session_ttl"12h"Сколько живёт сессия оператора без активности.
language"ru"Язык интерфейса по умолчанию: ru, en, kk.

Раздел [database]

ПараметрПо умолчаниюОписание
url—Строка подключения к PostgreSQL.
pool_size10Соединений с базой на один процесс. Для 100+ операторов — 20–30.
statement_timeout"30s"Предельное время одного запроса.

Раздел [files]

ПараметрПо умолчаниюОписание
storage"local"local — каталог на диске, s3 — внешнее хранилище.
max_size"25MB"Предельный размер одного вложения.
s3_endpoint, s3_bucket—Для storage = "s3". Ключи доступа задаются только переменными окружения.
retention_days0Через сколько дней удалять вложения закрытых заявок. 0 — не удалять.

Раздел [mail]

ПараметрПо умолчаниюОписание
poll_interval"60s"Как часто забирать почту из ящиков, где нет IMAP IDLE.
max_message_size"40MB"Письма крупнее отклоняются с уведомлением отправителю.
strip_quotestrueУбирать из ответов цитату предыдущего письма.
После правки файла перезапустите оба процесса: docker compose restart app worker. Проверить файл без перезапуска можно командой ezxdesk config check.

Обновлено 16 сентября 2026 · относится к версии 4.12