# Справочник переменных .env

# Справочник переменных .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`|`9000`|Порт 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`)|

---

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

|Переменная|Значение по умолчанию|Описание|
|:---|:---|:---|
|`LOG_LEVEL`|`WARNING`|Уровень детализации логов: `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`|

# Справочник переменных .env ПринтМенеджера

## Описание

Файл конфигурации ПринтМенеджера находится по пути `/opt/printmanager/.env`. Просмотреть текущее содержимое:

```
sudo cat /opt/printmanager/.env
```
---

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

|Переменная|Пример значения|Описание|
|---|---|---|
|`DATABASE_URL`|`postgres://<login>:<password>@<host>:<port>/<database>`|Строка подключения к PostgreSQL в формате URL|
|`DATABASE_HOSTNAME`|`127.0.0.1`|IP-адрес или доменное имя сервера PostgreSQL|
|`DATABASE_PORT`|`5432`|Порт PostgreSQL|
|`DATABASE_TABLESPACE`|—|Табличное пространство (если отличается от значения по умолчанию)|

---

## Redis

|Переменная|Пример значения|Описание|
|---|---|---|
|`REDIS_URL`|`redis://<password>:6379/0`|Строка подключения к Redis|
|`REDIS_PASSWORD`|`redis`|Пароль Redis (при смене)|
|`REDIS_ROLE`|`master`|Роль узла Redis: `master` или `slave`|
|`REDIS_SENTINEL_LIST`|`10.10.130.1,10.10.130.2,10.10.130.3`|Список адресов Redis Sentinel (через запятую)|
|`REDIS_MASTER_HOSTNAME`|`10.10.130.1`|Адрес мастер-узла Redis|
|`REDIS_MASTER_PORT`|`6379`|Порт мастер-узла Redis|

---

## NFS (кластерная конфигурация)

|Переменная|Пример значения|Описание|
|---|---|---|
|`VOLUME_PATH`|`/opt/printmanager/volumes`|Путь к директории томов|
|`DRIVER_OPTS_TYPE`|`nfs`|Тип драйвера хранилища: `nfs` или `none`|
|`DRIVER_OPTS_O`|`port=2049,nfsvers=4.2,addr=10.10.130.4,clientaddr=10.10.130.10,nolock,soft,rw`|Опции монтирования NFS. Для принудительного указания версии протокола добавить `nfsvers=4`|
|`DRIVER_OPTS_DEVICE`|`:/scratch`|Путь к директории на NFS-сервере (с ведущим `:`)|

---

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

|Переменная|Пример значения|Описание|
|---|---|---|
|`EXT_HOSTNAME`|`pm.test`|Домен или адрес балансировщика (внешний адрес ПринтМенеджера)|
|`PM_HOSTNAME`|`10.10.130.1`|Адрес текущего сервера ПринтМенеджера|
|`PM_HTTP_PORT`|`8010`|Порт HTTP-подключения к панели администрирования ПМ|
|`PM_HTTPS_PORT`|`8080`|Порт HTTPS-подключения к панели администрирования ПМ|

---

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

После изменения переменных необходимо перезапустить контейнеры:

```
sudo docker-compose down
sudo docker-compose up -d
```

|Переменная|Описание|
|---|---|
|`DATABASE_URL`|Обновить строку подключения: `postgres://postgres:NEW-PASSWORD@db:5432/printmanager`|
|`CUPS_PASSWORD`|Пароль CUPS|
|`FTP_SCAN_PASSWORD`|Пароль FTP для доставки сканов|