# Переменные .env Мониторинга

## Описание

Файл конфигурации Мониторинга находится по пути `/opt/printum/.env`. Переменные задаются при установке через параметры команды `install.sh` и могут быть изменены вручную после установки с последующим перезапуском контейнеров.

---

## Подключение к базам данных

|Переменная|Значение по умолчанию|Описание|
|:---|:---|:---|
|`POSTGRESQL_HOST`|встроенный|Адрес сервера PostgreSQL (при подключении к внешней БД)|
|`POSTGRESQL_PORT`|`5432`|Порт PostgreSQL|
|`POSTGRESQL_DATABASE`|`printum`|Имя базы данных|
|`POSTGRESQL_USER`|`postgres`|Пользователь PostgreSQL|
|`POSTGRESQL_PASSWORD`|—|Пароль пользователя PostgreSQL|
|`POSTGRESQL_SSLMODE`|—|Режим SSL-соединения: `allow`, `prefer`, `require`, `verify-ca`, `verify-full`|
|`POSTGRESQL_CERT_CA`|—|Абсолютный путь до CA-сертификата (при `verify-ca` или `verify-full`)|
|`CLICKHOUSE_HOST`|встроенный|Адрес сервера ClickHouse (при подключении к внешней БД)|
|`CLICKHOUSE_PORT`|`8123`|Порт ClickHouse|
|`CLICKHOUSE_DATABASE`|`printum`|Имя базы данных ClickHouse|
|`CLICKHOUSE_USER`|`default`|Пользователь ClickHouse|
|`CLICKHOUSE_PASSWORD`|—|Пароль пользователя ClickHouse|
|`CLICKHOUSE_SSL`|`False`|Включить SSL для подключения к ClickHouse (`True` / `False`)|
|`CLICKHOUSE_CERT_CA`|—|Путь до CA-сертификата ClickHouse|

---

## Сетевые настройки и hostname

|Переменная|Значение по умолчанию|Описание|
|:---|:---|:---|
|`MON_HOSTNAME`|—|IP-адрес или hostname сервера Мониторинга. Используется при установке по доменному имени|
|`IP_ADDRESS`|—|IP-адрес сервера. Используется при установке по IP-адресу (альтернатива `MON_HOSTNAME`)|

---

## Шифрование конфигурационного файла

|Переменная|Значение по умолчанию|Описание|
|:---|:---|:---|
|`ENV_VAULT_PASSWORD`|—|Пароль для шифрования файла `.env`. Задаётся при установке для активации шифрования конфигурации|

---

## Хранение архива печати

|Переменная|Значение по умолчанию|Описание|
|:---|:---|:---|
|`ARCHIVE_FREE_SPACE`|—|Размер свободного места (МБ), ниже которого запускается очистка архива|
|`ARCHIVE_SIZE_DELETE`|—|Объём (МБ), который освобождается при переполнении хранилища|
|`ARCHIVE_CHECKS_PERIOD_HOURS`|—|Интервал (ч) между проверками свободного места|

---

## Почтовая очередь печати (Print Mailbox)

|Переменная|Значение по умолчанию|Описание|
|:---|:---|:---|
|`PRINT_MAILBOX_HOST`|—|Адрес IMAP-сервера|
|`PRINT_MAILBOX_PORT`|—|Порт IMAP-сервера|
|`PRINT_MAILBOX_NAME`|—|Адрес почтового ящика для приёма заданий на печать|
|`PRINT_MAILBOX_PASSWORD`|—|Пароль для почтового приложения (не пароль от самой почты)|
|`PRINT_MAILBOX_USE_SSL`|—|Включить шифрование SSL (`True` / `False`)|
|`PRINT_MAILBOX_USE_TLS`|—|Включить шифрование TLS (`True` / `False`)|

---

## SMB-хранилище сканов

|Переменная|Значение по умолчанию|Описание|
|:---|:---|:---|
|`SMB_HOSTNAME`|—|Hostname или IP-адрес сервера с сетевой папкой|
|`SMB_USERNAME`|—|Имя пользователя для записи в сетевую папку|
|`SMB_PASSWORD`|—|Пароль пользователя для записи в сетевую папку|
|`SCAN_SMB_ENCRYPT`|—|Включить шифрование SMB (требуется SMBv3+)|
|`STORAGE_SMB_ENCRYPT`|—|Включить шифрование для SMB-хранилища архива|

---

## Диагностика и логирование

|Переменная|Значение по умолчанию|Описание|
|:---|:---|:---|
|`DEBUG`|`False`|Включить режим отладки (`True` для диагностики)|
|`LOG_LEVEL`|`INFO`|Уровень детализации логов: `DEBUG`, `INFO`, `WARNING`, `ERROR`|

---

## Смена паролей

При смене паролей необходимо обновить соответствующие переменные в `.env` файле и перезапустить контейнеры:

    sudo docker-compose down

    sudo docker-compose up -d

|Переменная|Описание|
|:---|:---|
|`CLICKHOUSE_PASSWORD`|Пароль ClickHouse|
|`REDIS_URL`|Строка подключения Redis с паролем: `redis://:NEW-PASSWORD@redis:6379/0`|
|`REDIS_PASSWORD`|Пароль Redis|
|`CACHEOPS_REDIS`|Строка подключения Redis для кэша: `redis://:NEW-PASSWORD@redis:6379/1`|