Home Connect Local-Only Integration Setup

Home Connect appliances from Bosch and Siemens can be controlled locally in Home Assistant using the Home Connect Local custom integration. The setup has two parts: first you download appliance profiles (encryption keys and feature descriptions) with the Home Connect Profile Downloader tool, then you install the integration through HACS and upload those profiles.

Before You Start

Confirm the following before you begin:

1. Your appliances are connected to your Home Connect account and work in the Home Connect app.
2. You have your Home Connect account username and password available.
3. HACS is installed. If it is not, follow the HACS download guide first.
4. You have a computer (Windows, macOS, or Linux) to run the profile downloader.

Step 1: Download the Appliance Profiles

1. Download the Home Connect Profile Downloader for your platform from the releases page .
2. Install and open the application:
   • Windows: extract the ZIP file and run the .exe file.
   • macOS: run xattr -cr on the application file in Terminal to clear the quarantine flag, then open it.
   • Linux: install the .rpm or .deb package, or run the AppImage.
3. Sign in with your Home Connect account username and password.
4. Select openHAB as the target format.
5. Save the resulting ZIP file. It contains the encryption keys and feature descriptions for each appliance.

Step 2: Install Home Connect Local Through HACS

1. In Home Assistant, go to HACS and open Custom Repositories.
2. Add the Home Connect Local repository as a custom repository.
3. Download the integration.
4. Restart your Home Assistant instance.

Step 3: Add Your Appliances

1. Go to Settings > Devices & Services > Add Integration and select Home Connect Local.
2. Upload the profile file you downloaded in Step 1.
3. Select the appliance you want to set up.
4. If the initial connection fails, you are asked to enter the appliance’s IP address manually.
5. Repeat from step 2 of this section for each additional appliance.