Variables d'environnement

Toute la configuration de Miravo peut être définie via des variables d’environnement. Les flags CLI ont la priorité sur les variables d’env.

Simulation

Variable	Défaut	Description
MIRAVO_NAME	Dérivé du template	Nom de la simulation
MIRAVO_TEMPLATE	Auto-sélection	Nom ou chemin du template
MIRAVO_HOME	~/.miravo	Répertoire de base pour le registre local et la persistance

MQTT

Variable	Défaut	Description
MIRAVO_MQTT_PORT	1883	Port du broker (0 = éphémère)
MIRAVO_MQTT_HOST	127.0.0.1	Hôte de liaison du broker
MIRAVO_MQTT_MODE	embedded	embedded ou external
MIRAVO_MQTT_URL	—	URL du broker externe (ex. mqtt://broker:1883)
MIRAVO_MQTT_USERNAME	—	Nom d’utilisateur du broker externe
MIRAVO_MQTT_PASSWORD	—	Mot de passe du broker externe

Réglage MQTT

Variable	Défaut	Plage	Description
MIRAVO_MQTT_DRAIN_BUDGET	16384	512-65536	Messages max par cycle de drain intégré
MIRAVO_MQTT_BATCH_SIZE	2048	64-16384	Publications synchrones avant de céder à la boucle événementielle
MIRAVO_MQTT_BROKER_CONCURRENCY	500	10-5000	Concurrence interne des messages aedes

OPC UA

Variable	Défaut	Description
MIRAVO_OPCUA_PORT	4840	Port du serveur OPC UA
MIRAVO_OPCUA_HOST	0.0.0.0	Hôte de liaison du serveur OPC UA
MIRAVO_OPCUA_WRITE_BUDGET	8192	Écritures max dans l’espace d’adresses par cycle de drain (512-65536)

Les variables d’env OPC UA ne sont lues que quand OPC UA est activé (--opcua).

Serveur admin

Variable	Défaut	Description
MIRAVO_ADMIN_HOST	127.0.0.1	Hôte de liaison du serveur HTTP admin
MIRAVO_ADMIN_PORT	8080	Port du serveur HTTP admin
MIRAVO_ADMIN_URL	—	URL du serveur admin pour les commandes client (status, inject)
MIRAVO_ADMIN_TOKEN	—	Jeton bearer pour les endpoints de mutation. Requis pour les liaisons non-loopback.

Affichage

Variable	Défaut	Description
NO_COLOR	—	Quand définie (toute valeur non vide), force la sortie texte brut

Valeurs par défaut Docker

L’image Docker de Miravo définit ces valeurs par défaut :

MIRAVO_ADMIN_HOST=0.0.0.0
MIRAVO_ADMIN_PORT=8080

Remplacez-les dans docker run ou Docker Compose :

docker run --rm \
  -e MIRAVO_ADMIN_PORT=9090 \
  -e MIRAVO_MQTT_PORT=1884 \
  -e MIRAVO_NAME=my-sim \
  -p 1884:1884 -p 9090:9090 \
  amineamaach/miravo:latest