Busclear · Support
Support
Something isn't working or you have an idea? Here you'll find answers to common questions and how to reach us.
Contact
Please report bugs, questions and requests as an issue on GitHub: GitHub Issues
For anything that should not be public, send us an email: support@busclear.de
Help us help you quickly
- Device and version (e.g. iPhone, iOS 26, Busclear 1.9 or the Home Assistant add-on)
- Manufacturer and model of your KNX interface or IP router
- What you did, what happened and what you expected
- A screenshot if possible. Issues are public: please don't upload your ETS project or any passwords. Group addresses and project details are best sent as a diagnostics package by e-mail, see [Feedback](https://busclear.de/en/feedback/).
Frequently asked questions
Can I try the app without a KNX system?
Yes. “Try the demo without a KNX system” on the start screen opens a sample house with a project and live values. Your own project stays untouched.
Which KNX interfaces are supported?
Any KNXnet/IP interface or IP router, for example a Gira X1. Tunnelling works over UDP or TCP; with an IP router you can also use routing, which needs no tunnel (not yet on iPhone and iPad, where multicast needs approval from Apple). The app does not support USB and serial interfaces; the KNX box can connect the bus line directly through the kBerry plug-on module.
Why can't I connect although the interface is reachable?
IP interfaces only offer a few tunnels, often four or fewer. If visualisation, ETS or other apps use all of them, the interface refuses. Free a tunnel, configure an additional one in ETS, or use routing.
Is KNX Secure supported?
Yes: KNX IP Secure for the tunnel and KNX Data Secure for encrypted group addresses. Import the keyring (.knxkeys) from ETS. The keys are kept in your device’s keychain. If something doesn’t work with your interface, please report it on GitHub.
How do I back up my data, and who can get at it?
From version 1.9.1 the app can save everything from this device into one file with its own password (at least 12 characters). It stays wherever you put it, and nobody can reset the password, not even us. Not included are the app lock and the history on a box. Details are in the privacy policy.
Do I need an ETS project?
No, the bus monitor works without one, and you can teach in your installation without ETS. With a project you get names, datapoint types, rooms and better checks. The password of a protected project is only used during import and is not stored.
How do I get the desktop version?
Linux does everything the iPad app does. The download is in the GitHub release. Windows follows in the coming weeks; on the Mac, Busclear comes through the App Store.
What do I need for the KNX box?
A Raspberry Pi 4 (tested) or 5, ideally with a USB SSD and a real-time clock (Pi 5: battery), an IP gateway or the kBerry plug-on module, plus the app: on iPhone, iPad and Android in the coming weeks, on Linux today. The box also sets its clock from the iPhone or the KNX time master. The ready-made image is in the GitHub releases, everything else on the KNX box page; it is a first preview.
The app doesn't find my interface automatically.
Discovery uses multicast on the local network. Guest Wi-Fi, VLANs or mesh systems sometimes block it. In that case, enter the interface’s IP address manually. On iPhone, local network access must also be allowed (Settings → Busclear).
Importing my ETS project fails.
Check that the password is correct and the file is complete (.knxproj exported directly from ETS). Alternatively, export the group addresses as CSV from ETS and import that.