Home Assistant Installation Guide
This page describes the installation of the Bosch integration.
You Home Assistant should have a HACS installed and fully working. Please follow the guide at HACS for guidance. Manual installation of the integration is possible, but not covered on this page.
The integration is using HTTP and XMPP to connect to the Bosch gateway. XMPP uses uport 5222 and 5223. HTTP communication requires port 80. Please ensure that your network has no blocking firewall for XMPP traffic.
Connection to a CT200 EasyControl requires a credentials. The gateway serial number and token are on the back of the device or on a separate sticker. The password needs to be set at the EasyControl App
In order to add the Bosch integration to HA via HACS, you need to download the repository. Go to HACS and select Integration. Add the repo by using the Plus button in the right lower corner. Search for Bosch and select the right repro (not Bosch SHC or Bosch Indego Mower).
Download the repository and restart Home Assistant.
You need to reboot HA core to make the newly downloaded repro available in HA.
Note that in a fresh install the HACS add on needs some time to collect all repos. You can check the HACS status by using About. .
Move to Configuration in your Home Assistant sidebar and select Integration:
Use the right lower corner button to add an integration.
A search dialog appears that shows all integrations available for your installation. If HACS is working successfully, your should be able to search for Bosch by entering it in the search line.
Select Bosch as integration for installation and click on it. Bosch SHC is the Smart Home Controller and NOT the integration for Buderus, Junkers etc.
NOTE: In case you only get the Bosch SHC as search result, please restart your HA installation and clear the browser cache.
After clicking on the integration, you need to select your heating control system. This guide is specific to EasyControl. NEFIT and IVT may differ. For the Buderus KM50, KM100 or KM200 select IVT.
You will need to enter the gateway serial number, the token and the EasyControl password now. The device has preset serial number and token. These are printed on the back of the EasyControl and on the little manual provided by Bosch. They look like this: Serial 101042138, Access Code: 7Eq4jClmTLAlfbT6. The EasyControl password is set by you. NOTE: There were reports of issues with passwords longer than 8 letters and with passwords that contained special characters. If the integration does not work, please check the password.
For the Buderus (IVT) KM50, KM100 or KM200 you must enter the IP-address of the gateway, then the Password from the sticker and final the Password what you selected befor.
Be patient now. Your Home Assistant is connecting to the Bosch gateway and fetches the system configuration. This will take more than 10 seconds and should complete within 2 minutes. As a result, the integration will show your setup. Before pressing Finish, you may want to set the Area of the diffent devices.
In the case below, we have 4 zones or rooms set up. These have Bosch thermostats in each zone. This is equivalent to the rooms setup in the EasyControl app. The other devices are the gateway and the heater itself.
Pressing Finish will show the integrated Bosch heating system and it's entities. The thermostats will show up in your default Lovelace System Overview after a couple of seconds. Be patient again. NOTE: Many entities/sensors are NOT activated. This needs to be done next.
You will find serial and token on the back of your EasyControl. This sticker shows them as Login Name and Password.
Do not enter the - in the password. The printed password 7Eq4-jClm-TLAl-fbT6 should be entered as 7Eq4jClmTLAlfbT6.
- Go to Settings:
- Go to Personal
- Next screen has option to Change your thermostat password. There were reports of issues with passwords longer than 8 letters and with passwords that contained special characters. If the integration does not work, please check the password.
You can check the status of the HACS installation by selecting About in HACS. It should show more that 900 repos. If this is not the case, you need to check the HACS installation.
