Le serveur se configure par variables d’environnement préfixées par AQUAS_. Les niveaux
sont séparés par un double souligné : AQUAS_MQTT__PASSWORD règle password dans le groupe mqtt.
En installation Docker, placez-les dans le fichier .env.
| Variable |
Défaut |
Rôle |
AQUAS_PUBLIC_URL |
http://localhost:8080 |
Adresse à laquelle vous ouvrez l’interface |
AQUAS_HTTP_PORT |
8080 |
Port HTTP de l’interface (Docker) |
AQUAS_TIMEZONE |
Europe/Paris |
Fuseau horaire de l’installation : sert aux échéances « du jour » et aux rappels (les dates sont stockées en temps universel) |
AQUAS_TASK_REMINDER_HOUR |
8 |
Heure locale du rappel des tâches du jour |
AQUAS_LOG_LEVEL |
INFO |
Niveau de journalisation |
AQUAS_SECRET_KEY |
générée |
Clé de signature des sessions |
| Variable |
Défaut |
Rôle |
AQUAS_DEFAULT_ADMIN_USERNAME |
admin |
Identifiant créé au premier démarrage |
AQUAS_DEFAULT_ADMIN_PASSWORD |
ChangeMe123! |
Mot de passe initial, à changer à la première connexion |
| Variable |
Défaut |
Rôle |
AQUAS_AUTH__COOKIE_SECURE |
true |
true si l’interface est servie en HTTPS, false en HTTP simple |
AQUAS_AUTH__COOKIE_SAMESITE |
none |
Politique SameSite du cookie de session (lax en Docker) |
| Variable |
Défaut |
Rôle |
AQUAS_MQTT__HOST |
localhost |
Adresse du broker vue par le serveur |
AQUAS_MQTT__PORT |
1883 |
Port du broker |
AQUAS_MQTT__USER |
user |
Compte MQTT (serveur et contrôleurs) |
AQUAS_MQTT__PASSWORD |
— |
Mot de passe MQTT, obligatoire |
AQUAS_MQTT__DEVICE_HOST |
= HOST |
Adresse du broker vue par les ESP32, si elle diffère |
AQUAS_MQTT__TOPIC_PREFIX |
aquarium |
Racine des sujets MQTT, pour partager un broker entre installations |
Ces valeurs sont écrites dans le firmware des ESP32.
| Variable |
Défaut |
Rôle |
AQUAS_ESP__SSID |
— |
Nom du réseau Wi-Fi |
AQUAS_ESP__PASSWORD |
— |
Mot de passe Wi-Fi |
AQUAS_NETWORK__GATEWAY |
192.168.1.254 |
Passerelle |
AQUAS_NETWORK__SUBNET |
255.255.255.0 |
Masque de sous-réseau |
AQUAS_NETWORK__DNS1 |
192.168.1.254 |
Serveur DNS |
AQUAS_NETWORK__START / __END |
192.168.1.50 / .99 |
Plage d’IP fixes attribuées aux contrôleurs |
L’assistant se règle dans l’interface, Configuration › Assistant IA : voir
Assistant IA. Il n’a plus de variable d’environnement.
| Variable |
Défaut |
Rôle |
AQUAS_PUSH__ENABLED |
true |
Active les notifications push |
AQUAS_PUSH__CONTACT |
mailto:admin@example.org |
Contact exigé par les services de push, mettez votre adresse |
AQUAS_PUSH__VAPID_PRIVATE_KEY |
générée |
Clé VAPID, générée et conservée si absente |
Telegram et ntfy se configurent depuis l’interface : voir Alertes.
| Variable |
Défaut |
Rôle |
AQUAS_SENSOR_READING_RETENTION_DAYS |
365 |
Historique des capteurs (0 = illimité) |
AQUAS_ALERT_RETENTION_DAYS |
90 |
Alertes résolues |
AQUAS_ACTIVATION_RETENTION_DAYS |
90 |
Journal des mises en marche des équipements |
AQUAS_AUDIT_RETENTION_DAYS |
365 |
Journal d’activité |
AQUAS_LOG_DAY_RETENTION |
30 |
Journaux techniques |
AQUAS_BACKUP_RETENTION_DAYS |
5 |
Sauvegardes « avant restauration » conservées (les automatiques : nombre réglé dans l’appli) |
Le reste se règle dans Configuration › Sauvegarde : voir Sauvegardes.
| Variable |
Défaut |
Rôle |
AQUAS_BACKUP_AUTO_DEFAULT |
false |
Sauvegarde automatique activée tant qu’elle n’a pas été réglée dans l’appli |
AQUAS_BACKUP_EXTERNAL_PATH |
vide |
Dossier externe proposé par défaut (partage monté dans le conteneur, ex. /backups-nfs) |
| Variable |
Défaut |
Rôle |
AQUAS_HUB_URL |
https://hub.aquasmanager.fr |
Service de l’éditeur : synchronisation du catalogue commun, propositions d’espèces et d’idées, commandes groupées. none : désactivé |
AQUAS_CATALOG_SYNC_HOURS |
6 |
Intervalle de synchronisation du catalogue commun, en heures |
Les propositions partent du navigateur, sans identifiant ni donnée de votre installation ; seule
la fiche proposée et le message éventuel sont envoyés.
| Variable |
Défaut |
Rôle |
AQUAS_GO2RTC_URL |
vide |
Adresse de l’API du service vidéo go2rtc (ex. http://go2rtc:1984). Vide : caméras désactivées |
