Файл настроек
Все настройки сервера задаются в файле 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 | — | Адрес, по которому система открывается у пользователей. Используется в письмах и ссылках. |
listen | 127.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_size | 10 | Соединений с базой на один процесс. Для 100+ операторов — 20–30. |
statement_timeout | "30s" | Предельное время одного запроса. |
Раздел [files]
| Параметр | По умолчанию | Описание |
storage | "local" | local — каталог на диске, s3 — внешнее хранилище. |
max_size | "25MB" | Предельный размер одного вложения. |
s3_endpoint, s3_bucket | — | Для storage = "s3". Ключи доступа задаются только переменными окружения. |
retention_days | 0 | Через сколько дней удалять вложения закрытых заявок. 0 — не удалять. |
Раздел [mail]
| Параметр | По умолчанию | Описание |
poll_interval | "60s" | Как часто забирать почту из ящиков, где нет IMAP IDLE. |
max_message_size | "40MB" | Письма крупнее отклоняются с уведомлением отправителю. |
strip_quotes | true | Убирать из ответов цитату предыдущего письма. |
После правки файла перезапустите оба процесса: docker compose restart app worker.
Проверить файл без перезапуска можно командой ezxdesk config check.
Обновлено 16 сентября 2026 · относится к версии 4.12