mirror of
https://github.com/YunoHost-Apps/zwave-js-ui_ynh.git
synced 2024-09-03 18:06:00 +02:00
62 lines
3 KiB
Markdown
62 lines
3 KiB
Markdown
<!--
|
|
N.B.: This README was automatically generated by https://github.com/YunoHost/apps/tree/master/tools/README-generator
|
|
It shall NOT be edited by hand.
|
|
-->
|
|
|
|
# Zwave-JS-UI for YunoHost
|
|
|
|
[](https://dash.yunohost.org/appci/app/zwave-js-ui)  
|
|
[](https://install-app.yunohost.org/?app=zwave-js-ui)
|
|
|
|
*[Lire ce readme en français.](./README_fr.md)*
|
|
|
|
> *This package allows you to install Zwave-JS-UI quickly and simply on a YunoHost server.
|
|
If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/install) to learn how to install it.*
|
|
|
|
## Overview
|
|
|
|
|
|
### Features
|
|
|
|
Integrate zwave-js-ui natively in Domoticz_ynh.
|
|
|
|
**Zwave-JS-UI**, also known under previous name ZWaveJS2MQTT, is a replacement for Openzwave. It exposes Z-Wave devices to an MQTT broker in a fully configurable manner.
|
|
|
|
To work correctly, this app require to install either
|
|
- [domoticz package](https://github.com/YunoHost-Apps/domoticz_ynh) with **mqtt broker Mosquitto**
|
|
- or [Home-Assistant package](https://github.com/YunoHost-Apps/homeassistant_ynh)
|
|
|
|
Suivez le [guide d'installation rapide](https://zwave-js.github.io/zwave-js-ui/#/getting-started/quick-start?id=minimum-settings) pour l'intégrer dans l'une ou l'autre de ces applications.
|
|
|
|
**Shipped version:** 8.8.1~ynh1
|
|
## Disclaimers / important information
|
|
|
|
|
|
|
|
|
|
For now, although the package is fully functional (install, remove, backup, restore...), it is not integrated with domoticz and mosquitto package, this means that all settings needs to be done manually from inside the app.
|
|
|
|
|
|
During install, the whole app need to be recompile using yarn, this lead to long installation time. Also, a temporary swap file will be created if less than 2Gb of memory (RAM+Swap) are available : Be sure to have enough space on disk.
|
|
## Documentation and resources
|
|
|
|
* Official app website: <https://zwave-js.github.io/zwave-js-ui/#/>
|
|
* Official user documentation: <https://www.domoticz.com/wiki/Zwave-JS-UI>
|
|
* Official admin documentation: <https://zwave-js.github.io/zwave-js-ui/#/>
|
|
* Upstream app code repository: <https://github.com/zwave-js/zwave-js-ui>
|
|
* YunoHost documentation for this app: <https://yunohost.org/app_zwave-js-ui>
|
|
* Report a bug: <https://github.com/YunoHost-Apps/zwave-js-ui_ynh/issues>
|
|
|
|
## Developer info
|
|
|
|
Please send your pull request to the [testing branch](https://github.com/YunoHost-Apps/zwave-js-ui_ynh/tree/testing).
|
|
|
|
To try the testing branch, please proceed like that.
|
|
|
|
``` bash
|
|
sudo yunohost app install https://github.com/YunoHost-Apps/zwave-js-ui_ynh/tree/testing --debug
|
|
or
|
|
sudo yunohost app upgrade zwave-js-ui -u https://github.com/YunoHost-Apps/zwave-js-ui_ynh/tree/testing --debug
|
|
```
|
|
|
|
**More info regarding app packaging:** <https://yunohost.org/packaging_apps>
|