# Home Connect

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/home-connect/

_Requires Symcon >= 6.0_

### Description

The Home Connect module allows devices from Bosch, Siemens, Gaggenau and Neff, which support the Home Connect service, to be integrated into IP-Symcon.

### Integration in IP-Symcon

> **Note:** The use of the Home Connect-Module requires an activated connection to the [Connect service](connect-control.md), which in turn requires an active subscription.

#### Home Connect Configurator Create Instance

In order for the Home Connect module to be used, it must first be installed via the [Module Store](../components/management-console.md). To do this, the [Module Store](../components/management-console.md) must be opened. It is located in the upper right area. The Home Connect module can be found via the search field via “Home Connect”. When opening the found module, the installation of the module can be initiated in the following dialog via the "Install" button.

![Find module](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/home-connect/16146c7523-1790424938/home-connect-module.png)

![Install module](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/home-connect/2f9ea5d4c3-1790424938/home-connect-module-install.png)

The add dialog for creating a Home Connect configurator instance then opens.

If the instance is to be added manually, an [Instance](../concepts.md) must be created by the Home Connect configurator. To do this, the object tree must first be opened. In this the "+" button at the bottom right must be pressed and [Instance](../concepts.md) selected.

![Add instance](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/home-connect/0e1b553a5a-1790424938/alexa-add-instance.png)

With the help of the quick search, the “Home Connect Configurator” can be found by the manufacturer “(configurator)”. The location should not be changed, the name can be chosen freely. Finally, confirm with "OK".

![Create instance](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/home-connect/90e05d02ad-1790424938/home-connect-create-instance.png)

After the configurator instance has been created, it automatically opens and can be set up.

#### Home Connect Setup Configurator Instance
Before devices can be created, one must register with a click on Register in order to connect IP-Symcon to the Home Connect account.
In the 'Language' field, one can select in which language the information about the devices is processed. The language you select here is not related to the language used in IP-Symcon.

![Connect Symcon](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/home-connect/750c802948-1790424938/home-connect-register.png)

One must log in with the Home Connect account to grant IP-Symcon the necessary permissions.

![Login](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/home-connect/c799bd08dc-1790424938/home-connect-login.png)

![Grant access](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/home-connect/22d67b4ea4-1790424938/home-connect-grant-access.png)

The “Configure Interface” dialog can then be confirmed with Next. The SSE client that was created must now be activated.

![SSE client](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/home-connect/748c5d3328-1790424938/home-connect-sse.png)

Now the configurator opens and all recognized devices can be created with a click on "Create".

![Configurator](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/home-connect/a94c8ce460-1790424938/home-connect-configurator.png)

## Device list

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/home-connect/device-list/

### Supported Devices

The Home Connect service is provided by devices from Bosch, Siemens, Gaggenau and Neff.

| Device type     |
| --------------- |
| Coffee machine  |
| Oven            |
| Dryer           |
| Washing Machine |
| Dishwasher      |
| Refrigerator    |
| Freezer         |
If a device is not in the list above, it can still be added to IP-Symcon. If problems arise during setup, our support team will be happy to help.

## Home Connect Device

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/home-connect/home-connect-device/

_Requires Symcon >= 6.0_

### Description

When a device is created by the Home Connect configurator, a Home Connect device instance is created which has various status variables depending on the device type.

### Control by IP-Symcon
In order to be able to use the devices to the full extent, the remote start and/or remote control must be activated directly on the device. If only the remote control is active, programs and options can be changed, but the program cannot be started. While the device is being operated locally, it cannot be controlled by IP-Symcon.
### Status variables
Each device can have 4 different types of variables.
#### Status
Status type variables are variables that cannot be switched by IP-Symcon.
__Examples:__ Operating status, Local operation active

#### Setting
Variables of the setting type can usually be switched and are used to change various settings of the device.
__Examples:__ Temperature (refrigerator), Energy status

#### Program
Each device has only one variable of the type program. This variable can be used to determine which program is to be executed by the device.

> **Note:** If a program, that is available in the Home Connect app, is not displayed in IP-Symcon, then it is not supported by the API. If such a program is selected manually via the app or the device, then all setting options are grayed out

#### Options
When a program is selected, corresponding option variables are created that change the details for the selected program.
__Examples:__ Capacity (coffee machine), Duration (oven)

When a program has been selected and the available options have been set, the program can be started using the Control variable.
As soon as a program has been started, depending on the device, variables are created that provide information on the progress.
__Examples:__ Program progress, Remaining runtime

### Particularities

* When creating a device, it should be online and therefore switched on
* The refrigerator has no programs

### Troubleshooting

#### A device instance is not created correctly
All data of a device can be requested again in the device instance by clicking on the 'Initialize device' button.
#### Variables are not updated
Click on 'Register server events' to re-establish the connection to the Home Connect service.