Details regarding installation

Mosquitto

Head over to Supervisor -> Add-on Store and find the Mosquitto broker. Install and start it.

Add api user for Mosquitto

Add a Home Assistant user for the Plejd addon to be able to connect to Mosquitto Configuration -> Users Call the user e.g. mqtt-api-user, set a password and save

Plejd

Follow the Easy Installation in README.MDAnd Configuration Parameters on the same page.The only parameters needing a value are

site
username (typically email address)
password
mqttUsername e.g. mqtt-api-user
mqttPassword

Now you can start the Plejd add-on

Where are the lights?

Head over to Configuration -> Integrations and the Configure MQTT. After this step a new Mosquitto broker core-mosquitto should appear on the MQTT Page. If everything was setup correctly. It will list your lights under devices/entities subheading.

Running the Plejd add-on in VirtualBox on Windows

If on Windows + VirtualBox or similar setup

Install VirtualBox extensions to get USB 2/3
Redirect correct USB device
Potentially try to replace BT drivers with WinUSB using Zadig
(Re)start VirtualBox HA machine

Running the Plejd add-on outside of Home Assistant Operating System ("HassOS")

If you're planning on running this add-on outside of HassOS, you might need to turn off AppArmor in the config.json file. This is due to missing AppArmor configuration that is performed in HassOS (if you've manually done it, ignore this).

Open the config.json file and locate host_dbus, after that line, insert: "apparmor": "no", and then restart the add-on.

More information about available parameters can be found here: https://developers.home-assistant.io/docs/en/hassio_addon_config.html

Migration from 32bit to 64 bit

If you restore a backup from a 32bit system to a new 64bit system, use the Rebuild option in the Add-on

2.1 KiB Raw Blame History