Описание переменных .env для booco

Сервер BOOCO Astra (v 2.x) / booco

Переменная
Обязательная
Значение по умолчанию
Описание
USE_HTTPS
0
Разрешение использовать https. Если 1 — разрешен https, если 0 — используется http
DBHOST_URL
http://localhost:3002
URL-адрес микросервиса bosql
MQTT_PASSWORD
Пароль пользователя MQTT. Рекомендуется в пароле не использовать символы: :, /, ?, #, [, ], @(если используете, то пароль нужно взять в кавычки)
AMQP_URL
✔
Адрес RabbitMQ. Указывается в формате: amqp://login:password@hostname, где: login и password — логин и пароль для доступа к RabbitMQ; hostname — название хоста RabbitMQ
MQTT_URL
URL MQTT-брокера
TZ
Europe/Moscow
Часовой пояс
TRUSTED_DOMAINS
✔ 
URL-адреса доменов, которым разрешено встраивать booco iframe-модули. Множественные значения должны быть разделены пробелом, например: http://localhost:5173 http://localhost:3000. Важно: в списке URL-адресов доменов должен быть адрес текущего домена, на котором расположен сервер BOOCO
SECRET_KEY
✔
Ключ шифрования cookies на стороне booco. Указывается произвольно
ROOT_URL
✔
URL сервера BOOCO
BOOCO_BUILD
Версия микросервиса booco
HTTP_PORT
80
Порт для доступа к booco
SSL_KEY_PATH
Путь к приватному ключу сертификата SSL
SSL_CERT_PATH
Путь к сертификату SSL
BOSQL_EXCHANGE
✔
Имя exchange в RabbitMQ = значению переменной RMQ_EXCHANGE из файла .env для микросервиса bosql
USE_MQTT
false
Запрет/разрешение использования протокола MQTT для связи с оборудованием. Если true — разрешено
MQTT_USER
Логин пользователя MQTT
LOG_URL
http://localhost:3001
URL-адрес микросервиса master-logger
LDAP_ACCESS_URL
URL-адрес микросервиса ldap-access (если есть интеграция с LDAP)

Пример файла .env для booco:

ROOT_URL=https://<hostname>
USE_HTTPS=0
BOOCO_BUILD=2.18.0
TZ=Europe/Moscow
#SSL_KEY_PATH=/data/privkey.pem
#SSL_CERT_PATH=/data/fullchain.pem
HTTP_PORT=80
AMQP_URL=amqp://admin:password@rabbitmq
BOSQL_EXCHANGE=booco-db1
DBHOST_URL=http://bosql:3002
LDAP_ACCESS_URL=http://ldap-access:3003
USE_MQTT=true
MQTT_URL=mqtt://rabbitmq:1883
MQTT_USER=mqtt-system
MQTT_PASSWORD=password
LOG_URL=http://localhost:3001
TRUSTED_DOMAINS=http://localhost:5173
SECRET_KEY=8Zz5tw0Ionm3XPZZfN0NOml3z9FMfmpgXwovR9fp6ryDIoGRM8EPHAB6iHsc0fb

Настройка автообновления страницы со списком ресурсов после добавления ресурса в BOOCO 2.x

Чтобы после добавления ресурса он появлялся в списке ресурсов автоматически (без ручного обновления страницы), в файле .env для сервиса booco должны быть корректно настроены переменные:

  • ROOT_URL;
  • USE_HTTPS;
  • AMQP_URL;
  • BOSQL_EXCHANGE.
⚠️
После изменения файла .env нужно выполнить команды: docker compose down и docker compose up -d.