Connect a working KNX installation to Home Assistant with the official KNX integration, using an ETS6 project as the source of group addresses. Background remains in the KNX introduction, hardware and software starter.
Complexity
Moderate if ETS already commissions the line and you have a KNXnet/IP interface. Advanced if you are introducing KNX Secure.
1. Preconditions
- The bus is programmed and a test group already works from a wall switch or from ETS.
- You have a KNXnet/IP router or interface on a reserved IP, on a trusted LAN. Do not expose KNXnet/IP to the internet.
- You have the ETS6 project (and, for KNX Secure, the possibility to export a .knxkeys file).
Official Home Assistant KNX docs describe connection via a tunnel or via routing. In short:
- Tunneling is a point-to-point KNXnet/IP connection to an interface. It is the usual first choice for a single Home Assistant host.
- Routing uses multicast and is a different topology — use it when you already understand how your IP routers and multicast are set up, not as a first experiment.
3. Import the group addresses, do not invent them
- Export or type group addresses from ETS, with the correct DPT (switch, dimming, temperature, and so on).
- For KNX Secure, official docs describe using a .knxkeys keyring exported from ETS, rather than copying raw keys into a forum post.
- Start with one lighting group: a switch entity or light entity, written and read back. Confirm the wall switch and Home Assistant stay in step.
Scenes and "all off" automations should send the same group addresses ETS already uses. Do not create a second unofficial address scheme in Home Assistant that ETS cannot see.
5. Safety
New KNX power supplies, devices on the bus, or 230 V output modules remain licensed electrical work. ETS programming of an existing commissioned site should be done by someone who holds the project and understands the line. See the electrical-compliance thread in Site News.
Hardware cost
A KNXnet/IP interface, if you do not already have one, should be quoted in AUD from a KNX supplier. ETS licensing is sold by KNX / official distributors; this thread does not invent a price.
Official reading
Home Assistant KNX
KNX introduction · KNX software starter
Researched from official documentation on 15 November 2026 (Australia/Sydney). This is a planning and how-to guide, not a claim that the exact hardware combination was assembled and tested on a live site. Please correct anything that has moved on.