Skip to content

Tips and tricks

t0mg edited this page Oct 20, 2017 · 1 revision

Some tips and tricks for advanced users.

Home screen button

On Android, iOS and Windows it is possible to add a Reacticz icon to your home screen. When launched from it, Reacticz will appear fullscreen (ie without url bar or browser buttons) - looking pretty much like a native app.

See this guide for platform-specific guidance on how to create home screen shortcuts.

Multiple dashboards on the same device

Running out of screen space? Want to have separate dashboards for separate rooms or occasions?

You can actually create more than one Reacticz dashboard on a given device/browser. Since v0.1.10, when unlocking your dahsboard, a bar shows up at the bottom of the screen. Click the + button to add a new blank dashboard. You can then use the arrows to switch between your dashboards.

Server settings are shared between all dashboards, but the device selection and layout will be specific to each. When sharing your configuration from the About page, you can choose to also share the layout of your current dashboard. Only one dashboard can be shared at a time.

Note for iOS users: on Android, adding an alternative dashboard to your home screen will work as expected. However on iOS, this operation creates a sandboxed version of the page every time, meaning that a new blank Reacticz dasboard will be created every time. You can use the URL-based config sharing options from the About page to copy your settings to the new sandboxed app.

Note if you were using the experimental multi-dashboard of 0.1.9: The data model has changed in 0.1.10 but it should migrate automatically when you upgrade. Note that the original ids of your dashboards might change in the process (eg the first dashboard was ?1 and is now ?0).

Securing Domoticz, Reacticz and MQTT websockets with https/wss

Requirements

  • a public FQDN pointing to your Domoticz host
  • a local install of Reacticz in the same server as Domoticz
  • everything already working in non-secure mode (including MQTT broker with websockets properly setup)

Step by step

First of all, secure Domoticz and Reacticz URLs with SSL (for free with Let's Encrypt) as per Domoticz wiki.

Secure also your MQTT broker with the same free SSL certificate: add the following lines to the websockets listener in your MQTT config file:

certfile /etc/letsencrypt/live/put_your_FQDN_here/cert.pem
cafile /etc/letsencrypt/live/put_your_FQDN_here/chain.pem
keyfile /etc/letsencrypt/live/put_your_FQDN_here/privkey.pem
password_file /etc/mosquitto/pwfile

Add a user and a password to Mosquitto (reference here):

sudo mosquitto_passwd -c /etc/mosquitto/pwfile put_your_USERNAME_here

Then restart both Mosquitto and Domoticz.

Finally in Reacticz server settings, add the secured websockets URL:

wss://put_your_FQDN_here:put_your_WEBSOCKETS_LISTENER_here

and enable authentication to fill out your credentials. Update the Domoticz section with the new secure url as well (https). You are done!