ioBroker KISSHome defender

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.

This special adapter was developed for the KISSHome defender project. It is not intended for general use.

To use this adapter, you must first register on the KISSHome defender website and get the confirmation email.

To run this adapter, you need:

• More than 3 smart home devices
• Fritz!Box Router. Without Fritz!Box, the adapter will not work.
• iobroker must run on debian/raspbian (or at least on linux, where the following commands are available: which, rsync)
• Docker must be installed and enabled for the user iobroker to run the IDS container

Enable Docker for user iobroker

By older Linux systems to install docker, you must do the following steps

By new systems (Debian 12, Ubuntu 22.04 and newer) you can install docker by the following commands:

sudo apt update
sudo apt install -y docker-ce
sudo systemctl start docker
sudo systemctl enable docker  
sudo usermod -aG docker iobroker

Add command docker to the sudoers file:

sudo visudo /etc/sudoers.d/iobroker

Add the following line:

iobroker ALL=(ALL) NOPASSWD: /usr/bin/docker

Changelog

1.1.13 (2025-11-25)

• (@GermanBluefox) Allowed editing of the description for automatically found devices

1.1.12 (2025-11-12)

• (@GermanBluefox) Changed german name of adapter
• (@GermanBluefox) Sync names of PCAP files

1.1.10 (2025-11-09)

• (@GermanBluefox) Showed progress devices that have only IP address

1.1.9 (2025-11-06)

• (@GermanBluefox) Try to handle 127.0.0.1 as no bind given
• (@GermanBluefox) Recreate IDS container on error if self-hosted
• (@GermanBluefox) Limit minimal interval for sending PCAPs to 10 minutes

1.1.8 (2025-11-05)

• (@GermanBluefox) Allowed only selection IPv4 addresses and not loopback for communication with docker

1.1.7 (2025-11-05)

• (@GermanBluefox) Corrected error if device is offline
• (@GermanBluefox) Show error codes 400-499 as warning and not as error

1.1.6 (2025-11-04)

• (@GermanBluefox) Showed error message if IDS has an error

1.1.5 (2025-11-04)

• (@GermanBluefox) Destroy docker container on adapter stop
• (@GermanBluefox) Required admin 7.7.19 as dependency

1.1.3 (2025-11-01)

• (@GermanBluefox) Disabled by default self-hosted docker option
• (@GermanBluefox) Changed default threshold value

1.1.1 (2025-10-31)

• (@GermanBluefox) Changed the calculation of the first occurrence time
• (@GermanBluefox) Added link to FAQ in email

1.1.0 (2025-10-30)

• (@GermanBluefox) Corrected JSON config

1.0.20 (2025-10-29)

• (@GermanBluefox) Do not send empty error log
• (@GermanBluefox) Do not send config too often
• (@GermanBluefox) Changed wording

1.0.16 (2025-10-28)

• (@GermanBluefox) Added error log proxying

1.0.15 (2025-10-27)

• (@GermanBluefox) Reset the file upload state if IDS restarting
• (@GermanBluefox) Hide some control elements if instance is offline
• (@GermanBluefox) Added countdown to the manual trigger button
• (@GermanBluefox) Send configuration to the container at start

1.0.11 (2025-10-23)

• (@GermanBluefox) Disable docker settings if not possible

1.0.10 (2025-10-21)

• (@GermanBluefox) Increased the saving data threshold

1.0.9 (2025-10-20)

• (@GermanBluefox) Show digits after comma in charts

1.0.7 (2025-10-15)

• (@GermanBluefox) Corrected the volume for docker
• (@GermanBluefox) Added min,max,step for questionnaire (number)

1.0.6 (2025-10-08)

• (@GermanBluefox) Improved selection of IP address

1.0.5 (2025-10-08)

• (@GermanBluefox) Packages were updated
• (@GermanBluefox) Corrected questionnaire
• (@GermanBluefox) Send save_threshold_seconds to the container

1.0.4 (2025-09-24)

• (@GermanBluefox) Allowed setting of the port and the bind address for Docker

1.0.1 (2025-09-22)

• (@GermanBluefox) Fixing questionnaire under Firefox

1.0.0 (2025-09-19)

• (@GermanBluefox) Removed sensitivity parameter
• (@GermanBluefox) Corrected colors in the chart

0.3.2 (2025-09-11)

• (@GermanBluefox) Corrected callback URL

0.3.1 (2025-09-10)

• (@GermanBluefox) Implemented mobile view

0.3.0 (2025-09-08)

• (@GermanBluefox) Implemented the daily status report

0.2.1 (2025-09-05)

• (@GermanBluefox) Showed names of the devices in the chart legend

0.2.0 (2025-09-04)

• (@GermanBluefox) Added direct link to the alarm in the widget

0.1.9 (2025-09-03)

• (@GermanBluefox) Look for vis-(2) project with kisshome widget

0.1.8 (2025-09-03)

• (@GermanBluefox) Fixed GUI issues
• (@GermanBluefox) Send results to cloud sync folder

0.1.6 (2025-08-30)

• (@GermanBluefox) Do not show scores for later time

0.1.5 (2025-08-29)

• (@GermanBluefox) Fixing the detections in GUI

0.1.4 (2025-08-28)

• (@GermanBluefox) Corrected message sending

0.1.3 (2025-08-28)

• (@GermanBluefox) Removed test cases

0.1.1 (2025-08-27)

• (@GermanBluefox) Initial commit

License

The MIT License (MIT)

Copyright (c) 2025 Denis Haev [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.