ETS project import (.knxproj)
You can import a full ETS project at any time, not only in the setup wizard — for example after the ETS project was extended with a new floor.
What you need: the .knxproj file exported from ETS 5 or 6 (and its password, if the project is protected), and a recent backup of the server (see “Backup & Restore”).
-
On the KNX page, open the Bridge tab and click Import KNX Project in the header. The button is shown on this tab only, and it opens the file picker directly.
-
Choose the
.knxprojfile. For a protected project, enter the ETS project Password and click Unlock. -
Review the preview summary: Building, Floors / Rooms, Widgets to create, Group addresses, Skipped functions.
-
Under What to import, tick the sections you want: Building structure, Group addresses, Functions (widgets). Untick a section to leave that part of your configuration exactly as it is — importing group addresses alone refreshes the library without disturbing rooms or widgets.
-
Optionally click Review & edit to correct the proposal before anything is created: rename devices, change widget types, move devices between rooms, exclude devices entirely (see the wizard's review pass, “First-Run Setup Wizard”, for the full walkthrough of this pane). The button is shown while Functions (widgets) is ticked.
-
If the server already holds rooms and devices, a warning explains your two ways forward. Choose:
- Merge (add new) — adds what is new and keeps your local edits. Nothing is deleted: a room or a device removed from the ETS project stays on the server. A room or a device you changed on the server since the previous import is left untouched; one you did not change is updated from the project.
- Replace all — rebuilds the ticked sections from the project. With Functions (widgets) ticked, it deletes every KNX device, including those you created by hand, and creates the devices again from the project. With Building structure ticked, the floors and rooms are deleted and created again too. Devices on other protocols are kept.
On a server with no rooms and no devices, a single Import button replaces the two.
-
Read the message that appears when the import ends. After a merge of all three sections it reads "Merged: X added, Y updated, Z kept (local edits)"; after a partial import it lists the rooms, widgets and group addresses that were processed. The message is brief, so note the counts if you need them. The new configuration is applied and the page reloads by itself: there is nothing to apply afterwards.
⚠️ Warning: Replace all removes every KNX device and its bindings in the sections you ticked — renames, room assignments and devices you created by hand included — and, with Building structure ticked, every room the project does not contain. Favorites that pointed at a replaced room or device are cleared. Scenarios and automations are not rebuilt, so check those that used a replaced device. When in doubt, choose Merge (add new).
📘 Note: Merge (add new) recognizes only what an earlier project import created. A room or a device you created by hand is not matched, so the import adds the project's version next to it.
📘 Note: If the ETS project declares no functions, HyperVisu infers devices from actuator channels and linked group addresses. The preview says so explicitly — review the inferred devices before importing.