From 623ca3209f8687848206887a754e540ce4d55a27 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 13:59:39 +0200 Subject: [PATCH 01/29] Create app_dispatch.fr.md --- .../10.docs/dispatch/app_dispatch.fr.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 pages/04.applications/10.docs/dispatch/app_dispatch.fr.md diff --git a/pages/04.applications/10.docs/dispatch/app_dispatch.fr.md b/pages/04.applications/10.docs/dispatch/app_dispatch.fr.md new file mode 100644 index 00000000..d1b0c819 --- /dev/null +++ b/pages/04.applications/10.docs/dispatch/app_dispatch.fr.md @@ -0,0 +1,23 @@ +--- +title: Dispatch +template: docs +taxonomy: + category: docs, apps +routes: + default: '/app_dispatch' +--- + +[![Installer Dispatch avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=dispatch) [![Integration level](https://dash.yunohost.org/integration/dispatch.svg)](https://dash.yunohost.org/appci/app/dispatch) + +### Index + +- [Liens utiles](#liens-utiles) + +*Dispatch* est un client graphique IRC basé sur une application web. + +## Liens utiles + ++ Site web : [github.com/khlieng/dispatch](https://github.com/khlieng/dispatch) ++ Démonstration : [Démo](https://dispatch.khlieng.com/) ++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/dispatch](https://github.com/YunoHost-Apps/dispatch_ynh) ++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/dispatch/issues](https://github.com/YunoHost-Apps/dispatch_ynh/issues) From 4220c36df53b52531dede4adfbafc07cd0a565cc Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 14:01:04 +0200 Subject: [PATCH 02/29] Create app_dispatch.md --- .../10.docs/dispatch/app_dispatch.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 pages/04.applications/10.docs/dispatch/app_dispatch.md diff --git a/pages/04.applications/10.docs/dispatch/app_dispatch.md b/pages/04.applications/10.docs/dispatch/app_dispatch.md new file mode 100644 index 00000000..53c56da8 --- /dev/null +++ b/pages/04.applications/10.docs/dispatch/app_dispatch.md @@ -0,0 +1,23 @@ +--- +title: Dispatch +template: docs +taxonomy: + category: docs, apps +routes: + default: '/app_dispatch' +--- + +[![Installer Dispatch with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=dispatch) [![Integration level](https://dash.yunohost.org/integration/dispatch.svg)](https://dash.yunohost.org/appci/app/dispatch) + +### Index + +- [Useful links](#useful-links) + +*Dispatch* is a web-based IRC graphical client. + +## Useful links + ++ Website: [github.com/khlieng/dispatch](https://github.com/khlieng/dispatch) ++ Demonstration: [Demo](https://dispatch.khlieng.com/) ++ Application software repository: [github.com - YunoHost-Apps/dispatch](https://github.com/YunoHost-Apps/dispatch_ynh) ++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/dispatch/issues](https://github.com/YunoHost-Apps/dispatch_ynh/issues) From a4a2848f2f820f44ce2e2b69ef62c645c81d83e7 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 14:01:45 +0200 Subject: [PATCH 03/29] Create app_domoticz.fr.md --- .../10.docs/domoticz/app_domoticz.fr.md | 132 ++++++++++++++++++ 1 file changed, 132 insertions(+) create mode 100644 pages/04.applications/10.docs/domoticz/app_domoticz.fr.md diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md new file mode 100644 index 00000000..877406b2 --- /dev/null +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -0,0 +1,132 @@ +--- +title: Domoticz +template: docs +taxonomy: + category: docs, apps +routes: + default: '/app_domoticz' +--- + +[![Installer Domoticz avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=domoticz) [![Integration level](https://dash.yunohost.org/integration/domoticz.svg)](https://dash.yunohost.org/appci/app/domoticz) + +### Index + +- [Liens utiles](#liens-utiles) + +*Domoticz* est un système domotique open source très léger qui vous permet de surveiller et de configurer divers appareils. + +### Avertissements / informations importantes + +Domoticz est un système de domotique permettant de controler différents objets et de recevoir des données de divers senseurs Il peut par exemple être utilisé avec : + + des interrupteurs + des senseurs de portes + des sonnettes d'entrées + des systèmes de sécurité + des stations météo pour les UV, la pluie, le vent... + des sondes de températures + des sondes d'impulsions + des voltmètres + Et bien d'autres + +Version incluse : Toujours la dernière version stable. La dernière version compilée est récupérée dans ce répertoire lors de l'installation. Une fois installée, les mises à jour de l'application sont gérées depuis les menus de l'application elle même. Le script de mise à jour Yunohost mettra uniquement à jour de nouvelles version du package. + +Le broker MQTT mosquitto est intégré au package et nécessite un sous-domaine ou un domaine distinct. Il est optionnel et si vous indiquez lors de l'installation le même domaine que le domaine principal, il ne sera pas installé. + +### Configuration + +#### Broker MQTT Mosquitto + +A l'installation, un broker MQTT, Mosquitto, est installé en même temps que Domoticz. La version installée est celle du dépot officiel du projet, et non des dépots Debian. Ce broker nécessite un domaine ou un sous-domaine particulier pour fonctionner (ex : mqtt.your.domain.tld) : il est nécessaire de créer ce domaine auparavant. + +##### Ajout dans domoticz + +Pour pouvoir l'utiliser, vous devez paramétrer la communication avec entre domoticz et le broker en suivant la documentation de domoticz dans la partie Add hardware "MQTT Client Gateway" Les users et mot de passe du broker sont automatiquement générés lors de l'installation. Vous pouvez les récupérer avec + +sudo yunohost app setting domoticz mqtt_user +sudo yunohost app setting domoticz mqtt_pwd + +##### Publier/souscrire + +Par défaut, mosquitto va écouter sur 2 ports: + + Le 1883 sur localhost en protocole mqtt + Le 8883 en protocole websocket. Nginx redirige le port 443 externe vers ce port en interne.e Pour publier/souscrire sur un topic depuis l'exterieur, vous devez donc utiliser un programme supportant le protocole websocket (ex : la bibliothèque python paho). + +##### Mosquitto_pub et mosquitto_sub + +Ces deux programmes ne supportent pas le protocole websocket mais uniquement le mqtt : le paramétrage de base ne vous autorise donc pas à les utiliser pour communiquer depuis un client externe. Si vous les utilisez directement depuis votre serveur, ce genre de syntaxe devrait marcher: + +mosquitto_pub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/in' -m '{ "idx" : 1, "nvalue" : 0, "svalue" : "25.0" }' + +De la même manière:c + +mosquitto_sub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/out' + +Si vous souhaitez ouvrir le protocole mqtt depuis l'extérieur afin de pouvoir les utiliser depuis un autre serveur, il vous faudra: + + ouvrir le port 1883 sur le firewall Yunohost (Attention, risque de sécurité) + autoriser les adresses IP souhaitées dans la configuration de mosquitto pour ce listener + paramétrer le tls dans la configuration de mosquitto en donnant accès au crt.pem et key.pem de votre domaine mqtt en les paramétrant respectivement avec les variables certfile et keyfile. Ceci est obligatoire pour sécuriser la connexion. + +##### Mise à jour depuis les versions n'ayant pas mosquittoo + +Si vous êtes sur le package ynh3 ou inférieur, mosquitto n'est pas installé par défaut. De même si vous avez choisi de ne pas indiquer de domaine pour mosquitto lors de l'installation initiale. Pour pouvoir l'installer après coup, faites les actions suivantes: + + créez un domaine ou sous-domaine pour recevoir les informations (par exemple : 'mqtt.your.domain.tld') + connecter vous en ligne de commande à votre serveur + taper la commande suivante : yunohost app setting domoticz mqtt_domain -v mqtt.your.domain.tld + Procédez à la mise à jour. Si vous êtes déjà sur la dernière version, utiliser la commmande suivante : yunohost app upgrade domoticz --force + +### Configuration + +Sensors, language and this kind of stuff + +Main configuration of the app take place inside the app itself. + +#### Senseurs, langue et ce genre de choses + +Toute la configuration de l'application a lieu dans l'application elle même + +#### Access et API + +Par défaut, l'accès aux API JSON est autorisé sur cette URL /votredomaine.tld/api_/chemindedomoticz. Donc, si vous accédez à domoticz par https://votredomaine.tld/domoticz, utilisez le chemin suivant pour l'api: /votredomaine.tld/api_/domoticz/json.htm?votrecommandeapi + +Par défaut, seuls la mise à jour de senseur et les interrupteurs sont autorisés. Pour autoriser une nouvelle commande, vous devez (pour l'instant) manuellement éditer le fichier de configuration nginx : + +sudo nano /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf + +Puis éditer le bloc suivant en y ajoutant le regex de la commmande à autoriser : + + #set the list of authorized json command here in regex format + #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's + #By default, sensors updates and toggle switch are authorized + if ( $args ~* type=command¶m=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command¶m=switchlight&idx=[0-9]*&switchcmd=Toggle$) { + set $api "1"; + } + +Par exemple, pour ajouter la commmande json pour retrouver le statut d'un équipement (/json.htm?type=devices&rid=IDX),il faut modifier la ligne comme ceci: + + #set the list of authorized json command here in regex format + #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's + #By default, sensors updates and toggle switch are authorized + if ( $args ~* type=command¶m=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command¶m=switchlight&idx=[0-9]*&switchcmd=Toggle$|type=devices&rid=[0-9]* ) { + set $api "1"; + } + +Toutes les adresses IPv4 du réseau local (192.168.0.0/24) et toutes les adresses IPv6 sont autorisées pour l'API. A ma connaissance, il n'y a pas moyen d'effectuer un filtre pour les adresses IPv6 sur le réseau local, vous pouvez donc retirer leur autorisation en enlevant ou en commentant la ligne suivante dans /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf: + +allow ::/1; + +Ceci autorisera seulement les adresses IPv4 local a accéder aux API de domoticz. Vous pouvez ajouter des adresses IPv6 de la même façon. + +### Limitations + + Pas de gestion d'utilisateurs ni d'intégration LDAP. L'application ne prévoit pas de gérer les utilisateurs par LDAP, donc le package non plus. + Un backup ne peut pas être restauré sur un type de machine différente de celle d'origine (x86, arm...) car les sources compilées doivent être différentes + +## Liens utiles + ++ Site web : [domoticz.com](https://domoticz.com/) ++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/domoticz](https://github.com/YunoHost-Apps/domoticz_ynh) ++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/domoticz/issues](https://github.com/YunoHost-Apps/domoticz_ynh/issues) From e1d892e28b3ededd862aa7aaf5affda346edc03c Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 14:02:00 +0200 Subject: [PATCH 04/29] Create app_domoticz.md --- .../10.docs/domoticz/app_domoticz.md | 131 ++++++++++++++++++ 1 file changed, 131 insertions(+) create mode 100644 pages/04.applications/10.docs/domoticz/app_domoticz.md diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.md b/pages/04.applications/10.docs/domoticz/app_domoticz.md new file mode 100644 index 00000000..4fe24da5 --- /dev/null +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.md @@ -0,0 +1,131 @@ +--- +title: Domoticz +template: docs +taxonomy: + category: docs, apps +routes: + default: '/app_domoticz' +--- + +[![Installer Domoticz with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=domoticz) [![Integration level](https://dash.yunohost.org/integration/domoticz.svg)](https://dash.yunohost.org/appci/app/domoticz) + +### Index + +- [Useful links](#useful-links) + +*Domoticz* is a very light weight open sources home automation system that lets you monitor and configure miscellaneous devices. + +### Disclaimers / important information + +Domoticz is a Home Automation system design to control various devices and receive input from various sensors. For example this system can be used with: + + Light switches + Door sensors + Doorbells + Security devices + Weather sensors like: UV/Rain/Wind Meters + Temperature Sensors + Pulse Meters + Voltage / AD Meters + And more ... + +Shipped version: Always the last stable one. The last compiled version is retrieved from this directory during install. Once installed, updates from the uptream app are managed from within the app. Yunohost upgrade script will only upgrade the Yunohost package. + +The MQTT broker mosquitto is integrated into the package. It requires its own domain or subdomain. It's an optional setting: during install if you set the same domaine as your main app domain, it won't be installed. + +### Configuration + +#### Broker Mosquitto + +During installation, a MQTT broker, Mosquitto, is installed at the same time as Domoticz. The installed version is the one from the official project repo and not from Debian ones. This broker requires a dedicated domain or subdomain to work (ex : mqtt.your.domain.tld) : creating this domain prior installation is a prerequisite + +##### Adding in domoticz + +To use mosquitto, you need to customize the communication between domoticz and the broker by following the domoticz documentation, part Add hardware "MQTT Client Gateway". User and password are automatically generated during installation, you may retrieve them with + +sudo yunohost app setting domoticz mqtt_user +sudo yunohost app setting domoticz mqtt_pwd + +##### Publish/Subscribe + +By default, mosquitto will listen on 2 ports: + + 1883 on localhost using mqtt protocol + 8883 using websocket protocol. Nginx redirect external port 443 to this internal port. + +Hence, To publish/subscribe on a topic from the outside, you have to use a software supporting websocket protocol (ex : paho python library). + +##### Mosquitto_pub et mosquitto_sub + +These 2 tools do not support websocket protocol, only direct mqtt: base settings will not allow communication from an outside device. If you're using them directly from your server, this kind of syntax should work: + +mosquitto_pub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/in' -m '{ "idx" : 1, "nvalue" : 0, "svalue" : "25.0" }' + +In the same way: + +mosquitto_sub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/out' + +If you wish to open direct mqtt protocol from an outside device, you'll need to: + + open port 1883 on Yunohost firewall (Attention, security risk) + Allows IP addresses in mosquitto configuration for this listener + Set the tls setting in mosquitto configuration by giving access to crt.pem and key.pem from your mqtt domain by setting respective certfile et keyfile variables. This is mandatory to ensure a secure connection. + +##### Upgrade from version without mosquitto + +If you have package ynh3 or below, mosquitto is not installed by default. If you have chosen to not set a domain during initial installation also. So, if you need to activate mosquitto in retrospect, do following actions: + + Create a domain or a subdomain (for example : 'mqtt.your.domain.tld') + Connect to your server in command line + Type following command : yunohost app setting domoticz mqtt_domain -v mqtt.your.domain.tld + Upgrade domoticz to last package. If you're already on the last package version, use the following command : yunohost app upgrade domoticz --force + +### Configuration + +Sensors, language and this kind of stuff + +Main configuration of the app take place inside the app itself. + +#### Access and API + +By default, access for the JSON API is allowed on following path /yourdomain.tld/api_/domoticzpath. So if you access domoticz via https://mydomainname.tld/domoticz, use the following webpath for the api : /mydomainname.tld/api_/domoticz/json.htm?yourapicommand + +By default, only sensor updates and switch toogle are authorized. To authorized a new command, you have (for now) to manually update the nginx config file : + +sudo nano /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf + +Then edit the following block by adding the regex of the command you want to allow: + + #set the list of authorized json command here in regex format + #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's + #By default, sensors updates and toggle switch are authorized + if ( $args ~* type=command¶m=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command¶m=switchlight&idx=[0-9]*&switchcmd=Toggle$) { + set $api "1"; + } + +For example, to add the json command to retrieve the status of a device (/json.htm?type=devices&rid=IDX),modify the line as this: + + #set the list of authorized json command here in regex format + #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's + #By default, sensors updates and toggle switch are authorized + if ( $args ~* type=command¶m=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command¶m=switchlight&idx=[0-9]*&switchcmd=Toggle$|type=devices&rid=[0-9]* ) { + set $api "1"; + } + +All IPv4 addresses within the local network (192.168.0.0/24) and all IPv6 addresses are authorized as API. As far as I know, there is no way to filter for IPv6 address on local network : You may remove the authorization by removing or commenting this line in /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf: + +allow ::/1; + +This will authorized only IPv4 within local network to access your domoticz API. You may add individual IPv6 address in the same way. + +### Limitations + + No user management nor LDAP integration This function is not planned to be implemented into the app, hence it's not planned into the package neither. + Backup cannot be restored on a different machine type (arm, x86...) as compiled sources are different + + +## Useful links + ++ Website: [domoticz.eu (en)](https://domoticz.eu/site/) ++ Application software repository: [github.com - YunoHost-Apps/domoticz](https://github.com/YunoHost-Apps/domoticz_ynh) ++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/domoticz/issues](https://github.com/YunoHost-Apps/domoticz_ynh/issues) From 7488722bf5692c70b1037c6d8de1e1e1983db4c8 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 14:02:22 +0200 Subject: [PATCH 05/29] Create app_droppy.fr.md --- .../10.docs/droppy/app_droppy.fr.md | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 pages/04.applications/10.docs/droppy/app_droppy.fr.md diff --git a/pages/04.applications/10.docs/droppy/app_droppy.fr.md b/pages/04.applications/10.docs/droppy/app_droppy.fr.md new file mode 100644 index 00000000..6bfe61b7 --- /dev/null +++ b/pages/04.applications/10.docs/droppy/app_droppy.fr.md @@ -0,0 +1,31 @@ +--- +title: Droppy +template: docs +taxonomy: + category: docs, apps +routes: + default: '/app_droppy' +--- + +[![Installer Droppy avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=droppy) [![Integration level](https://dash.yunohost.org/integration/droppy.svg)](https://dash.yunohost.org/appci/app/droppy) + +### Index + +- [Liens utiles](#liens-utiles) + +*Droppy* est un serveur de stockage de fichiers auto-hébergé avec une interface web et des capacités pour éditer des fichiers et visualiser des médias directement dans le navigateur. + +### Avertissements / informations importantes + +Le développement de Droppy a été abandonné par son auteur, et son dépôt de code a été archivé. N'attendez pas de future mise à jour, ni correctifs de sécurité. + +### Configuration + +Comment configurer cette application : un fichier de configuration /var/www/droppy/config/config.json en SSH. +Les fichiers partagés sont stockés dans le répertoire suivant : /home/yunohost.app/droppy/files/ + +## Liens utiles + ++ Site web : [github.com/silverwind/droppy](https://github.com/silverwind/droppy) ++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/droppy](https://github.com/YunoHost-Apps/droppy_ynh) ++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/droppy/issues](https://github.com/YunoHost-Apps/droppy_ynh/issues) From 4a36d44bdb0bfe9ea1c4a6f180992b423f419b31 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 14:02:36 +0200 Subject: [PATCH 06/29] Create app_droppy.md --- .../10.docs/droppy/app_droppy.md | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 pages/04.applications/10.docs/droppy/app_droppy.md diff --git a/pages/04.applications/10.docs/droppy/app_droppy.md b/pages/04.applications/10.docs/droppy/app_droppy.md new file mode 100644 index 00000000..0b1a78da --- /dev/null +++ b/pages/04.applications/10.docs/droppy/app_droppy.md @@ -0,0 +1,31 @@ +--- +title: Droppy +template: docs +taxonomy: + category: docs, apps +routes: + default: '/app_droppy' +--- + +[![Installer Droppy with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=droppy) [![Integration level](https://dash.yunohost.org/integration/droppy.svg)](https://dash.yunohost.org/appci/app/droppy) + +### Index + +- [Useful links](#useful-links) + +*Droppy* is a self-hosted file storage server with a web interface and capabilities to edit files and view media directly in the browser. + +### Disclaimers / important information + +Development of Droppy has been abandoned by its author, and its repository has been archived. Expect no future updates nor security fixes. + +### Configuration + +How to configure this app: a JSON configuration file with SSH. /var/www/droppy/config/config.json. +Shared files are stored in the following directory: /home/yunohost.app/droppy/files + +## Useful links + ++ Website: [github.com/silverwind/droppy](https://github.com/silverwind/droppy) ++ Application software repository: [github.com - YunoHost-Apps/droppy](https://github.com/YunoHost-Apps/droppy_ynh) ++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/droppy/issues](https://github.com/YunoHost-Apps/droppy_ynh/issues) From 4f64fed561db64fee84302388f81fc0389cdc105 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:29:11 +0200 Subject: [PATCH 07/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 877406b2..d7ea564b 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -48,7 +48,7 @@ sudo yunohost app setting domoticz mqtt_pwd ##### Publier/souscrire -Par défaut, mosquitto va écouter sur 2 ports: +Par défaut, Mosquitto va écouter sur 2 ports : Le 1883 sur localhost en protocole mqtt Le 8883 en protocole websocket. Nginx redirige le port 443 externe vers ce port en interne.e Pour publier/souscrire sur un topic depuis l'exterieur, vous devez donc utiliser un programme supportant le protocole websocket (ex : la bibliothèque python paho). From 292c4521ab72f798d89b04a495f5d1a1ba6ddbac Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:29:20 +0200 Subject: [PATCH 08/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index d7ea564b..d95a81d4 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -50,7 +50,7 @@ sudo yunohost app setting domoticz mqtt_pwd Par défaut, Mosquitto va écouter sur 2 ports : - Le 1883 sur localhost en protocole mqtt + Le 1883 sur localhost en protocole MQTT Le 8883 en protocole websocket. Nginx redirige le port 443 externe vers ce port en interne.e Pour publier/souscrire sur un topic depuis l'exterieur, vous devez donc utiliser un programme supportant le protocole websocket (ex : la bibliothèque python paho). ##### Mosquitto_pub et mosquitto_sub From 376bffda7a0f8dcddaaeac1a41052adba26789c9 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:29:41 +0200 Subject: [PATCH 09/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index d95a81d4..24b8ae0b 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -51,7 +51,7 @@ sudo yunohost app setting domoticz mqtt_pwd Par défaut, Mosquitto va écouter sur 2 ports : Le 1883 sur localhost en protocole MQTT - Le 8883 en protocole websocket. Nginx redirige le port 443 externe vers ce port en interne.e Pour publier/souscrire sur un topic depuis l'exterieur, vous devez donc utiliser un programme supportant le protocole websocket (ex : la bibliothèque python paho). + Le 8883 en protocole websocket. NGINX redirige le port 443 externe vers ce port en interne. Pour publier/souscrire sur un topic depuis l'exterieur, vous devez donc utiliser un programme supportant le protocole websocket (ex : la bibliothèque Python paho-mqtt). ##### Mosquitto_pub et mosquitto_sub From 998f55c32cd246b2315d5687c36bc8165f4cd204 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:29:56 +0200 Subject: [PATCH 10/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 24b8ae0b..216e8e5e 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -55,7 +55,7 @@ Par défaut, Mosquitto va écouter sur 2 ports : ##### Mosquitto_pub et mosquitto_sub -Ces deux programmes ne supportent pas le protocole websocket mais uniquement le mqtt : le paramétrage de base ne vous autorise donc pas à les utiliser pour communiquer depuis un client externe. Si vous les utilisez directement depuis votre serveur, ce genre de syntaxe devrait marcher: +Ces deux programmes ne supportent pas le protocole websocket mais uniquement le MQTT : le paramétrage de base ne vous autorise donc pas à les utiliser pour communiquer depuis un client externe. Si vous les utilisez directement depuis votre serveur, ce genre de syntaxe devrait marcher : mosquitto_pub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/in' -m '{ "idx" : 1, "nvalue" : 0, "svalue" : "25.0" }' From 194e0b234be3a3261409a0586e97683fc84f3ab4 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:30:21 +0200 Subject: [PATCH 11/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 1 - 1 file changed, 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 216e8e5e..0b0762f9 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -80,7 +80,6 @@ Si vous êtes sur le package ynh3 ou inférieur, mosquitto n'est pas installé p ### Configuration -Sensors, language and this kind of stuff Main configuration of the app take place inside the app itself. From 4175048d7701f607d07b17ddee2b2c7079877558 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:31:11 +0200 Subject: [PATCH 12/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 0b0762f9..77531845 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -59,7 +59,7 @@ Ces deux programmes ne supportent pas le protocole websocket mais uniquement le mosquitto_pub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/in' -m '{ "idx" : 1, "nvalue" : 0, "svalue" : "25.0" }' -De la même manière:c +De la même manière : mosquitto_sub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/out' From cc98fc94aea8cbeab9c2e7e5b087d5322247ae19 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:31:29 +0200 Subject: [PATCH 13/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 1 - 1 file changed, 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 77531845..870f26eb 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -81,7 +81,6 @@ Si vous êtes sur le package ynh3 ou inférieur, mosquitto n'est pas installé p ### Configuration -Main configuration of the app take place inside the app itself. #### Senseurs, langue et ce genre de choses From cdfc404d070326f67200f514cbc3f4fa90bfc9ad Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:32:00 +0200 Subject: [PATCH 14/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 870f26eb..01414adf 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -57,7 +57,7 @@ Par défaut, Mosquitto va écouter sur 2 ports : Ces deux programmes ne supportent pas le protocole websocket mais uniquement le MQTT : le paramétrage de base ne vous autorise donc pas à les utiliser pour communiquer depuis un client externe. Si vous les utilisez directement depuis votre serveur, ce genre de syntaxe devrait marcher : -mosquitto_pub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/in' -m '{ "idx" : 1, "nvalue" : 0, "svalue" : "25.0" }' +`mosquitto_pub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/in' -m '{ "idx" : 1, "nvalue" : 0, "svalue" : "25.0" }'` De la même manière : From c15be332dc4417b4c29e2b96ec1f020650f73715 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:32:20 +0200 Subject: [PATCH 15/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 01414adf..e4a37ec5 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -82,7 +82,7 @@ Si vous êtes sur le package ynh3 ou inférieur, mosquitto n'est pas installé p -#### Senseurs, langue et ce genre de choses +#### Capteurs, langue... Toute la configuration de l'application a lieu dans l'application elle même From 53b556c998b7b8a99f71d6176449f20107c76a2b Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:33:23 +0200 Subject: [PATCH 16/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index e4a37ec5..5a818721 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -90,7 +90,7 @@ Toute la configuration de l'application a lieu dans l'application elle même Par défaut, l'accès aux API JSON est autorisé sur cette URL /votredomaine.tld/api_/chemindedomoticz. Donc, si vous accédez à domoticz par https://votredomaine.tld/domoticz, utilisez le chemin suivant pour l'api: /votredomaine.tld/api_/domoticz/json.htm?votrecommandeapi -Par défaut, seuls la mise à jour de senseur et les interrupteurs sont autorisés. Pour autoriser une nouvelle commande, vous devez (pour l'instant) manuellement éditer le fichier de configuration nginx : +Par défaut, seuls la mise à jour de capteur et les interrupteurs sont autorisés. Pour autoriser une nouvelle commande, vous devez (pour l'instant) manuellement éditer le fichier de configuration NGINX : sudo nano /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf From 311357e16720b4fa348d218f9986f8da9892cf99 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:33:36 +0200 Subject: [PATCH 17/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 5a818721..e3473351 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -92,7 +92,7 @@ Par défaut, l'accès aux API JSON est autorisé sur cette URL /votredomaine.tld Par défaut, seuls la mise à jour de capteur et les interrupteurs sont autorisés. Pour autoriser une nouvelle commande, vous devez (pour l'instant) manuellement éditer le fichier de configuration NGINX : -sudo nano /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf +`sudo nano /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf` Puis éditer le bloc suivant en y ajoutant le regex de la commmande à autoriser : From 1af81e3f8529b15b4b29376c6ff015d1a10a9e4d Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:33:55 +0200 Subject: [PATCH 18/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index e3473351..59415ba9 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -61,7 +61,7 @@ Ces deux programmes ne supportent pas le protocole websocket mais uniquement le De la même manière : -mosquitto_sub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/out' +`mosquitto_sub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/out'` Si vous souhaitez ouvrir le protocole mqtt depuis l'extérieur afin de pouvoir les utiliser depuis un autre serveur, il vous faudra: From 0e38d6be021be97025141c9e93d680745f941c2e Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:34:42 +0200 Subject: [PATCH 19/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 59415ba9..7a154410 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -63,7 +63,7 @@ De la même manière : `mosquitto_sub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/out'` -Si vous souhaitez ouvrir le protocole mqtt depuis l'extérieur afin de pouvoir les utiliser depuis un autre serveur, il vous faudra: +Si vous souhaitez ouvrir le protocole MQTT depuis l'extérieur afin de pouvoir les utiliser depuis un autre serveur, il vous faudra : ouvrir le port 1883 sur le firewall Yunohost (Attention, risque de sécurité) autoriser les adresses IP souhaitées dans la configuration de mosquitto pour ce listener From fd670f71779d99bb2d9d43edeacf5e4f4f7e2d0f Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:35:02 +0200 Subject: [PATCH 20/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 7a154410..7e0ddfeb 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -66,7 +66,7 @@ De la même manière : Si vous souhaitez ouvrir le protocole MQTT depuis l'extérieur afin de pouvoir les utiliser depuis un autre serveur, il vous faudra : ouvrir le port 1883 sur le firewall Yunohost (Attention, risque de sécurité) - autoriser les adresses IP souhaitées dans la configuration de mosquitto pour ce listener + autoriser les adresses IP souhaitées dans la configuration de Mosquitto paramétrer le tls dans la configuration de mosquitto en donnant accès au crt.pem et key.pem de votre domaine mqtt en les paramétrant respectivement avec les variables certfile et keyfile. Ceci est obligatoire pour sécuriser la connexion. ##### Mise à jour depuis les versions n'ayant pas mosquittoo From e5e1eee26b77732de1bf383770127c210491fb91 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:35:17 +0200 Subject: [PATCH 21/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 7e0ddfeb..862b5aa7 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -65,7 +65,7 @@ De la même manière : Si vous souhaitez ouvrir le protocole MQTT depuis l'extérieur afin de pouvoir les utiliser depuis un autre serveur, il vous faudra : - ouvrir le port 1883 sur le firewall Yunohost (Attention, risque de sécurité) + ouvrir le port 1883 sur le firewall YunoHost (attention, risque de sécurité) autoriser les adresses IP souhaitées dans la configuration de Mosquitto paramétrer le tls dans la configuration de mosquitto en donnant accès au crt.pem et key.pem de votre domaine mqtt en les paramétrant respectivement avec les variables certfile et keyfile. Ceci est obligatoire pour sécuriser la connexion. From b40bca43ece7462ce2542aa3bce0f439ebc6ce16 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:35:41 +0200 Subject: [PATCH 22/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 862b5aa7..851fab4b 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -76,7 +76,7 @@ Si vous êtes sur le package ynh3 ou inférieur, mosquitto n'est pas installé p créez un domaine ou sous-domaine pour recevoir les informations (par exemple : 'mqtt.your.domain.tld') connecter vous en ligne de commande à votre serveur taper la commande suivante : yunohost app setting domoticz mqtt_domain -v mqtt.your.domain.tld - Procédez à la mise à jour. Si vous êtes déjà sur la dernière version, utiliser la commmande suivante : yunohost app upgrade domoticz --force + Procédez à la mise à jour. Si vous êtes déjà sur la dernière version, utiliser la commmande suivante : `yunohost app upgrade domoticz --force` ### Configuration From ec228465e345d57014ccec2f2750d44bdbef0b49 Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:36:01 +0200 Subject: [PATCH 23/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 851fab4b..27bc3cfa 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -67,7 +67,7 @@ Si vous souhaitez ouvrir le protocole MQTT depuis l'extérieur afin de pouvoir l ouvrir le port 1883 sur le firewall YunoHost (attention, risque de sécurité) autoriser les adresses IP souhaitées dans la configuration de Mosquitto - paramétrer le tls dans la configuration de mosquitto en donnant accès au crt.pem et key.pem de votre domaine mqtt en les paramétrant respectivement avec les variables certfile et keyfile. Ceci est obligatoire pour sécuriser la connexion. + paramétrer le TLS dans la configuration de Mosquitto en donnant accès au crt.pem et key.pem de votre domaine MQTT en les paramétrant respectivement avec les variables certfile et keyfile. Ceci est obligatoire pour sécuriser la connexion. ##### Mise à jour depuis les versions n'ayant pas mosquittoo From 0b0421e5aae1c41cd94660e1e55bfe57b8da318a Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:36:22 +0200 Subject: [PATCH 24/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 27bc3cfa..ea1c889e 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -71,7 +71,7 @@ Si vous souhaitez ouvrir le protocole MQTT depuis l'extérieur afin de pouvoir l ##### Mise à jour depuis les versions n'ayant pas mosquittoo -Si vous êtes sur le package ynh3 ou inférieur, mosquitto n'est pas installé par défaut. De même si vous avez choisi de ne pas indiquer de domaine pour mosquitto lors de l'installation initiale. Pour pouvoir l'installer après coup, faites les actions suivantes: +Si vous êtes sur le package ynh3 ou inférieur, Mosquitto n'est pas installé par défaut. De même si vous avez choisi de ne pas indiquer de domaine pour Mosquitto lors de l'installation initiale. Pour pouvoir l'installer après coup, effectuez les actions suivantes : créez un domaine ou sous-domaine pour recevoir les informations (par exemple : 'mqtt.your.domain.tld') connecter vous en ligne de commande à votre serveur From 41a5fd19174c713d15960866cc2c07778da7860b Mon Sep 17 00:00:00 2001 From: pp-r <64266134+pp-r@users.noreply.github.com> Date: Mon, 3 Oct 2022 16:36:43 +0200 Subject: [PATCH 25/29] Update pages/04.applications/10.docs/domoticz/app_domoticz.fr.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com> --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index ea1c889e..67d58203 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -75,7 +75,7 @@ Si vous êtes sur le package ynh3 ou inférieur, Mosquitto n'est pas installé p créez un domaine ou sous-domaine pour recevoir les informations (par exemple : 'mqtt.your.domain.tld') connecter vous en ligne de commande à votre serveur - taper la commande suivante : yunohost app setting domoticz mqtt_domain -v mqtt.your.domain.tld + tapez la commande suivante : `yunohost app setting domoticz mqtt_domain -v mqtt.your.domain.tld` Procédez à la mise à jour. Si vous êtes déjà sur la dernière version, utiliser la commmande suivante : `yunohost app upgrade domoticz --force` ### Configuration From 73f0f23e3b6b91501f539d0b71d65e70a23375c6 Mon Sep 17 00:00:00 2001 From: ericgaspar Date: Mon, 3 Oct 2022 18:00:52 +0200 Subject: [PATCH 26/29] Fix typos --- .../10.docs/domoticz/app_domoticz.fr.md | 46 ++++++------- .../10.docs/domoticz/app_domoticz.md | 65 ++++++++++--------- 2 files changed, 58 insertions(+), 53 deletions(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index 67d58203..fc7678a9 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -15,7 +15,7 @@ routes: *Domoticz* est un système domotique open source très léger qui vous permet de surveiller et de configurer divers appareils. -### Avertissements / informations importantes +### Avertissements/informations importantes Domoticz est un système de domotique permettant de controler différents objets et de recevoir des données de divers senseurs Il peut par exemple être utilisé avec : @@ -26,36 +26,36 @@ Domoticz est un système de domotique permettant de controler différents objets des stations météo pour les UV, la pluie, le vent... des sondes de températures des sondes d'impulsions - des voltmètres - Et bien d'autres + des voltmètres et bien d'autres -Version incluse : Toujours la dernière version stable. La dernière version compilée est récupérée dans ce répertoire lors de l'installation. Une fois installée, les mises à jour de l'application sont gérées depuis les menus de l'application elle même. Le script de mise à jour Yunohost mettra uniquement à jour de nouvelles version du package. +Version incluse : Toujours la dernière version stable. La dernière version compilée est récupérée dans ce répertoire lors de l'installation. Une fois installée, les mises à jour de l'application sont gérées depuis les menus de l'application elle même. Le script de mise à jour YunoHost mettra uniquement à jour de nouvelles version du package. -Le broker MQTT mosquitto est intégré au package et nécessite un sous-domaine ou un domaine distinct. Il est optionnel et si vous indiquez lors de l'installation le même domaine que le domaine principal, il ne sera pas installé. +Le broker MQTT Mosquitto est intégré au package et nécessite un sous-domaine ou un domaine distinct. Il est optionnel et si vous indiquez lors de l'installation le même domaine que le domaine principal, il ne sera pas installé. ### Configuration #### Broker MQTT Mosquitto -A l'installation, un broker MQTT, Mosquitto, est installé en même temps que Domoticz. La version installée est celle du dépot officiel du projet, et non des dépots Debian. Ce broker nécessite un domaine ou un sous-domaine particulier pour fonctionner (ex : mqtt.your.domain.tld) : il est nécessaire de créer ce domaine auparavant. +À l'installation, un broker MQTT, Mosquitto, est installé en même temps que Domoticz. La version installée est celle du dépot officiel du projet, et non des dépots Debian. Ce broker nécessite un domaine ou un sous-domaine particulier pour fonctionner (ex : mqtt.your.domain.tld). Il est nécessaire de créer ce domaine auparavant. -##### Ajout dans domoticz - -Pour pouvoir l'utiliser, vous devez paramétrer la communication avec entre domoticz et le broker en suivant la documentation de domoticz dans la partie Add hardware "MQTT Client Gateway" Les users et mot de passe du broker sont automatiquement générés lors de l'installation. Vous pouvez les récupérer avec +##### Ajout dans Domoticz +Pour pouvoir l'utiliser, vous devez paramétrer la communication avec entre Domoticz et le broker en suivant la documentation de Domoticz dans la partie Add hardware "MQTT Client Gateway". Les utilisateurs et mot de passe du broker sont automatiquement générés lors de l'installation. Vous pouvez les récupérer avec +``` sudo yunohost app setting domoticz mqtt_user sudo yunohost app setting domoticz mqtt_pwd +``` ##### Publier/souscrire -Par défaut, Mosquitto va écouter sur 2 ports : +Par défaut, Mosquitto va écouter sur deux ports : Le 1883 sur localhost en protocole MQTT - Le 8883 en protocole websocket. NGINX redirige le port 443 externe vers ce port en interne. Pour publier/souscrire sur un topic depuis l'exterieur, vous devez donc utiliser un programme supportant le protocole websocket (ex : la bibliothèque Python paho-mqtt). + Le 8883 en protocole WebSocket. NGINX redirige le port 443 externe vers ce port en interne. Pour publier/souscrire sur un topic depuis l'exterieur, vous devez donc utiliser un programme supportant le protocole WebSocket (ex : la bibliothèque Python paho-mqtt). ##### Mosquitto_pub et mosquitto_sub -Ces deux programmes ne supportent pas le protocole websocket mais uniquement le MQTT : le paramétrage de base ne vous autorise donc pas à les utiliser pour communiquer depuis un client externe. Si vous les utilisez directement depuis votre serveur, ce genre de syntaxe devrait marcher : +Ces deux programmes ne supportent pas le protocole WebSocket mais uniquement le MQTT : le paramétrage de base ne vous autorise donc pas à les utiliser pour communiquer depuis un client externe. Si vous les utilisez directement depuis votre serveur, ce genre de syntaxe devrait marcher : `mosquitto_pub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/in' -m '{ "idx" : 1, "nvalue" : 0, "svalue" : "25.0" }'` @@ -69,9 +69,9 @@ Si vous souhaitez ouvrir le protocole MQTT depuis l'extérieur afin de pouvoir l autoriser les adresses IP souhaitées dans la configuration de Mosquitto paramétrer le TLS dans la configuration de Mosquitto en donnant accès au crt.pem et key.pem de votre domaine MQTT en les paramétrant respectivement avec les variables certfile et keyfile. Ceci est obligatoire pour sécuriser la connexion. -##### Mise à jour depuis les versions n'ayant pas mosquittoo +##### Mise à jour depuis les versions n'ayant pas Mosquitto -Si vous êtes sur le package ynh3 ou inférieur, Mosquitto n'est pas installé par défaut. De même si vous avez choisi de ne pas indiquer de domaine pour Mosquitto lors de l'installation initiale. Pour pouvoir l'installer après coup, effectuez les actions suivantes : +Si vous êtes sur le package ynh3 ou inférieur, Mosquitto n'est pas installé par défaut. De même si vous avez choisi de ne pas indiquer de domaine pour Mosquitto lors de l'installation initiale. Pour pouvoir l'installer après coup, effectuez les actions suivantes : créez un domaine ou sous-domaine pour recevoir les informations (par exemple : 'mqtt.your.domain.tld') connecter vous en ligne de commande à votre serveur @@ -81,42 +81,42 @@ Si vous êtes sur le package ynh3 ou inférieur, Mosquitto n'est pas installé p ### Configuration - #### Capteurs, langue... Toute la configuration de l'application a lieu dans l'application elle même #### Access et API -Par défaut, l'accès aux API JSON est autorisé sur cette URL /votredomaine.tld/api_/chemindedomoticz. Donc, si vous accédez à domoticz par https://votredomaine.tld/domoticz, utilisez le chemin suivant pour l'api: /votredomaine.tld/api_/domoticz/json.htm?votrecommandeapi +Par défaut, l'accès aux API JSON est autorisé sur cette URL `/votredomaine.tld/api_/chemindedomoticz`. Donc, si vous accédez à domoticz par `https://votredomaine.tld/domoticz`, utilisez le chemin suivant pour l'api : `/votredomaine.tld/api_/domoticz/json.htm?votrecommandeapi` Par défaut, seuls la mise à jour de capteur et les interrupteurs sont autorisés. Pour autoriser une nouvelle commande, vous devez (pour l'instant) manuellement éditer le fichier de configuration NGINX : `sudo nano /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf` Puis éditer le bloc suivant en y ajoutant le regex de la commmande à autoriser : - +``` #set the list of authorized json command here in regex format #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's #By default, sensors updates and toggle switch are authorized if ( $args ~* type=command¶m=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command¶m=switchlight&idx=[0-9]*&switchcmd=Toggle$) { set $api "1"; } +``` -Par exemple, pour ajouter la commmande json pour retrouver le statut d'un équipement (/json.htm?type=devices&rid=IDX),il faut modifier la ligne comme ceci: - +Par exemple, pour ajouter la commmande json pour retrouver le statut d'un équipement (`/json.htm?type=devices&rid=IDX`),il faut modifier la ligne comme ceci : +``` #set the list of authorized json command here in regex format #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's #By default, sensors updates and toggle switch are authorized if ( $args ~* type=command¶m=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command¶m=switchlight&idx=[0-9]*&switchcmd=Toggle$|type=devices&rid=[0-9]* ) { set $api "1"; } +``` +Toutes les adresses IPv4 du réseau local (192.168.0.0/24) et toutes les adresses IPv6 sont autorisées pour l'API. À ma connaissance, il n'y a pas moyen d'effectuer un filtre pour les adresses IPv6 sur le réseau local, vous pouvez donc retirer leur autorisation en enlevant ou en commentant la ligne suivante dans `/etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf:` -Toutes les adresses IPv4 du réseau local (192.168.0.0/24) et toutes les adresses IPv6 sont autorisées pour l'API. A ma connaissance, il n'y a pas moyen d'effectuer un filtre pour les adresses IPv6 sur le réseau local, vous pouvez donc retirer leur autorisation en enlevant ou en commentant la ligne suivante dans /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf: +`allow ::/1;` -allow ::/1; - -Ceci autorisera seulement les adresses IPv4 local a accéder aux API de domoticz. Vous pouvez ajouter des adresses IPv6 de la même façon. +Ceci autorisera seulement les adresses IPv4 local a accéder aux API de Domoticz. Vous pouvez ajouter des adresses IPv6 de la même façon. ### Limitations diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.md b/pages/04.applications/10.docs/domoticz/app_domoticz.md index 4fe24da5..43c23d2f 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.md @@ -15,7 +15,7 @@ routes: *Domoticz* is a very light weight open sources home automation system that lets you monitor and configure miscellaneous devices. -### Disclaimers / important information +### Disclaimers/important information Domoticz is a Home Automation system design to control various devices and receive input from various sensors. For example this system can be used with: @@ -26,97 +26,102 @@ Domoticz is a Home Automation system design to control various devices and recei Weather sensors like: UV/Rain/Wind Meters Temperature Sensors Pulse Meters - Voltage / AD Meters - And more ... + Voltage/AD Meters and more -Shipped version: Always the last stable one. The last compiled version is retrieved from this directory during install. Once installed, updates from the uptream app are managed from within the app. Yunohost upgrade script will only upgrade the Yunohost package. +Shipped version: Always the last stable one. The last compiled version is retrieved from this directory during install. Once installed, updates from the uptream app are managed from within the app. YunoHost upgrade script will only upgrade the YunoHost package. -The MQTT broker mosquitto is integrated into the package. It requires its own domain or subdomain. It's an optional setting: during install if you set the same domaine as your main app domain, it won't be installed. +The MQTT broker Mosquitto is integrated into the package. It requires its own domain or subdomain. It's an optional setting: during install if you set the same domaine as your main app domain, it won't be installed. ### Configuration #### Broker Mosquitto -During installation, a MQTT broker, Mosquitto, is installed at the same time as Domoticz. The installed version is the one from the official project repo and not from Debian ones. This broker requires a dedicated domain or subdomain to work (ex : mqtt.your.domain.tld) : creating this domain prior installation is a prerequisite +During installation, a MQTT broker, Mosquitto, is installed at the same time as Domoticz. The installed version is the one from the official project repo and not from Debian ones. This broker requires a dedicated domain or subdomain to work (ex : mqtt.your.domain.tld): creating this domain prior installation is a prerequisite. -##### Adding in domoticz - -To use mosquitto, you need to customize the communication between domoticz and the broker by following the domoticz documentation, part Add hardware "MQTT Client Gateway". User and password are automatically generated during installation, you may retrieve them with +##### Adding in Domoticz +To use Mosquitto, you need to customize the communication between Domoticz and the broker by following the Domoticz documentation, part Add hardware "MQTT Client Gateway". User and password are automatically generated during installation, you may retrieve them with +``` sudo yunohost app setting domoticz mqtt_user sudo yunohost app setting domoticz mqtt_pwd +``` ##### Publish/Subscribe -By default, mosquitto will listen on 2 ports: +By default, Mosquitto will listen on two ports: 1883 on localhost using mqtt protocol - 8883 using websocket protocol. Nginx redirect external port 443 to this internal port. + 8883 using websocket protocol. NGINX redirect external port 443 to this internal port. -Hence, To publish/subscribe on a topic from the outside, you have to use a software supporting websocket protocol (ex : paho python library). +Hence, To publish/subscribe on a topic from the outside, you have to use a software supporting WebSocket protocol (ex: paho-mqtt Python library). ##### Mosquitto_pub et mosquitto_sub -These 2 tools do not support websocket protocol, only direct mqtt: base settings will not allow communication from an outside device. If you're using them directly from your server, this kind of syntax should work: - +These two tools do not support WebSocket protocol, only direct MQTT: base settings will not allow communication from an outside device. If you're using them directly from your server, this kind of syntax should work: +``` mosquitto_pub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/in' -m '{ "idx" : 1, "nvalue" : 0, "svalue" : "25.0" }' - +``` In the same way: +``` mosquitto_sub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/out' +``` -If you wish to open direct mqtt protocol from an outside device, you'll need to: +If you wish to open direct MQTT protocol from an outside device, you'll need to: open port 1883 on Yunohost firewall (Attention, security risk) Allows IP addresses in mosquitto configuration for this listener - Set the tls setting in mosquitto configuration by giving access to crt.pem and key.pem from your mqtt domain by setting respective certfile et keyfile variables. This is mandatory to ensure a secure connection. + Set the TLS setting in mosquitto configuration by giving access to crt.pem and key.pem from your MQTT domain by setting respective certfile et keyfile variables. This is mandatory to ensure a secure connection. -##### Upgrade from version without mosquitto +##### Upgrade from version without Mosquitto -If you have package ynh3 or below, mosquitto is not installed by default. If you have chosen to not set a domain during initial installation also. So, if you need to activate mosquitto in retrospect, do following actions: +If you have package ynh3 or below, Mosquitto is not installed by default. If you have chosen to not set a domain during initial installation also. So, if you need to activate mosquitto in retrospect, do following actions: Create a domain or a subdomain (for example : 'mqtt.your.domain.tld') Connect to your server in command line - Type following command : yunohost app setting domoticz mqtt_domain -v mqtt.your.domain.tld - Upgrade domoticz to last package. If you're already on the last package version, use the following command : yunohost app upgrade domoticz --force + Type following command: `yunohost app setting domoticz mqtt_domain -v mqtt.your.domain.tld` + Upgrade domoticz to last package. If you're already on the last package version, use the following command: `yunohost app upgrade domoticz --force` ### Configuration -Sensors, language and this kind of stuff +Sensors, language... Main configuration of the app take place inside the app itself. #### Access and API -By default, access for the JSON API is allowed on following path /yourdomain.tld/api_/domoticzpath. So if you access domoticz via https://mydomainname.tld/domoticz, use the following webpath for the api : /mydomainname.tld/api_/domoticz/json.htm?yourapicommand +By default, access for the JSON API is allowed on following path `/yourdomain.tld/api_/domoticzpath`. So if you access domoticz via `https://mydomainname.tld/domoticz`, use the following webpath for the api: `/mydomainname.tld/api_/domoticz/json.htm?yourapicommand` -By default, only sensor updates and switch toogle are authorized. To authorized a new command, you have (for now) to manually update the nginx config file : +By default, only sensor updates and switch toogle are authorized. To authorized a new command, you have (for now) to manually update the NGINX config file: -sudo nano /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf +sudo nano `/etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf` Then edit the following block by adding the regex of the command you want to allow: #set the list of authorized json command here in regex format #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's #By default, sensors updates and toggle switch are authorized + ``` if ( $args ~* type=command¶m=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command¶m=switchlight&idx=[0-9]*&switchcmd=Toggle$) { set $api "1"; } - -For example, to add the json command to retrieve the status of a device (/json.htm?type=devices&rid=IDX),modify the line as this: + ``` +For example, to add the JSON command to retrieve the status of a device (`/json.htm?type=devices&rid=IDX`),modify the line as this: #set the list of authorized json command here in regex format #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's #By default, sensors updates and toggle switch are authorized + ``` if ( $args ~* type=command¶m=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command¶m=switchlight&idx=[0-9]*&switchcmd=Toggle$|type=devices&rid=[0-9]* ) { set $api "1"; } + ``` -All IPv4 addresses within the local network (192.168.0.0/24) and all IPv6 addresses are authorized as API. As far as I know, there is no way to filter for IPv6 address on local network : You may remove the authorization by removing or commenting this line in /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf: +All IPv4 addresses within the local network (192.168.0.0/24) and all IPv6 addresses are authorized as API. As far as I know, there is no way to filter for IPv6 address on local network: You may remove the authorization by removing or commenting this line in `/etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf`: -allow ::/1; +`allow ::/1;` -This will authorized only IPv4 within local network to access your domoticz API. You may add individual IPv6 address in the same way. +This will authorized only IPv4 within local network to access your Domoticz API. You may add individual IPv6 address in the same way. ### Limitations From 87f69b9e9f9060e1656e8cd9fe7fa97b5a72fbfd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=89ric=20Gaspar?= <46165813+ericgaspar@users.noreply.github.com> Date: Mon, 3 Oct 2022 18:04:40 +0200 Subject: [PATCH 27/29] Update pages/04.applications/10.docs/droppy/app_droppy.md --- pages/04.applications/10.docs/droppy/app_droppy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/droppy/app_droppy.md b/pages/04.applications/10.docs/droppy/app_droppy.md index 0b1a78da..57b770ba 100644 --- a/pages/04.applications/10.docs/droppy/app_droppy.md +++ b/pages/04.applications/10.docs/droppy/app_droppy.md @@ -21,7 +21,7 @@ Development of Droppy has been abandoned by its author, and its repository has b ### Configuration -How to configure this app: a JSON configuration file with SSH. /var/www/droppy/config/config.json. +How to configure this app: a JSON configuration file with SSH. `/var/www/droppy/config/config.json.` Shared files are stored in the following directory: /home/yunohost.app/droppy/files ## Useful links From 9c436c8785f8f835b06157845bf41baedbafd958 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=89ric=20Gaspar?= <46165813+ericgaspar@users.noreply.github.com> Date: Mon, 3 Oct 2022 18:04:46 +0200 Subject: [PATCH 28/29] Update pages/04.applications/10.docs/droppy/app_droppy.md --- pages/04.applications/10.docs/droppy/app_droppy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/04.applications/10.docs/droppy/app_droppy.md b/pages/04.applications/10.docs/droppy/app_droppy.md index 57b770ba..043857fc 100644 --- a/pages/04.applications/10.docs/droppy/app_droppy.md +++ b/pages/04.applications/10.docs/droppy/app_droppy.md @@ -22,7 +22,7 @@ Development of Droppy has been abandoned by its author, and its repository has b ### Configuration How to configure this app: a JSON configuration file with SSH. `/var/www/droppy/config/config.json.` -Shared files are stored in the following directory: /home/yunohost.app/droppy/files +Shared files are stored in the following directory: `/home/yunohost.app/droppy/files` ## Useful links From 1bb73287fdcfba60bb9052e7e20711e134c5eeb7 Mon Sep 17 00:00:00 2001 From: ericgaspar Date: Mon, 3 Oct 2022 18:37:35 +0200 Subject: [PATCH 29/29] Update app_domoticz.fr.md --- pages/04.applications/10.docs/domoticz/app_domoticz.fr.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md index fc7678a9..14703aab 100644 --- a/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md +++ b/pages/04.applications/10.docs/domoticz/app_domoticz.fr.md @@ -80,10 +80,9 @@ Si vous êtes sur le package ynh3 ou inférieur, Mosquitto n'est pas installé p ### Configuration - #### Capteurs, langue... -Toute la configuration de l'application a lieu dans l'application elle même +Toute la configuration de l'application a lieu dans l'application elle-même. #### Access et API @@ -112,7 +111,7 @@ Par exemple, pour ajouter la commmande json pour retrouver le statut d'un équip set $api "1"; } ``` -Toutes les adresses IPv4 du réseau local (192.168.0.0/24) et toutes les adresses IPv6 sont autorisées pour l'API. À ma connaissance, il n'y a pas moyen d'effectuer un filtre pour les adresses IPv6 sur le réseau local, vous pouvez donc retirer leur autorisation en enlevant ou en commentant la ligne suivante dans `/etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf:` +Toutes les adresses IPv4 du réseau local (192.168.0.0/24) et toutes les adresses IPv6 sont autorisées pour l'API. À ma connaissance, il n'y a pas moyen d'effectuer un filtre pour les adresses IPv6 sur le réseau local, vous pouvez donc retirer leur autorisation en enlevant ou en commentant la ligne suivante dans `/etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf` : `allow ::/1;`