Home Assistant Installation Guide
This page describes the installaton 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. Please ensure that your network has no blocking firewall for XMPP traffic. XMPP uses under normal circumstances port 5222 and or 5223.
Connection to a CT200 EasyControl requires a password. This needs to be set at the EasyControl App. See details below
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.
After clicking on the integration, you need to select your heating control system. This guide is specific to EasyControl. NEFIT and IVT may differ.
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: sBxycamTLAlfbT6K. The EasyControl 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.
- Go to Settings:
2. 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.
To setup component go to Integration page in Home Assistant, click + to add integration and choose
Bosch thermostat.
Choose your device type. For:
- CT200 - EasyControl,
- NEFIT - NEFIT
- KM200, RC300 etc. - IVT
Choose protocol for IVT - either XMPP or HTTP (HTTP is local). For rest of devices it's only possible to use XMPP. Then screen will appear with following inputs:
- SERIAL Number / IP Address
- Access token
- Password
Now you have to find sticker on your KM device (sample sticker below) and put info as follows:
- IP Address -> ip address of your device
- Access token -> password from sticker without dashes (-)
- Password -> password you set in application My Mode or similar. For EasyControl look note below. #password-in-easycontrol-type-app-ct200
If you want put devices in areas. Wait for about 5 seconds and choose area for gateway. More devices should come up on the screen. Choose areas you want. Click submit.
Go to sensors section in Wiki to configure sensors.