2026.10.0
Home ▸ Integrations

Bosch SHC

The Bosch SHC integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to connect your Bosch Smart Home Controller to Home Assistant to control and monitor your Bosch Smart Home devices. Use case: combine your door and window contacts with your covers and switches to build a home security and comfort setup that reacts to what’s actually happening in your home.

Supported devices

The integration supports devices connected to a Bosch Smart Home Controller, including:

  • Door/Window Contacts and Door/Window Contact II
  • Motion Detectors
  • Smoke Detectors
  • Thermostats and Room Thermostats
  • Twinguard
  • Smart Plugs and Smart Plug Compact
  • Light Switches
  • Shutter Controls
  • Micromodule Shutter Controls and Micromodule Blinds
  • Bosch Smart Home cameras (selected controls only)

The entities available for a device depend on the capabilities reported by the controller.

Prerequisites

Before setting up the integration:

  1. Make sure the Bosch Smart Home Controller and Home Assistant are on the same local network.
  2. Have the system password of your controller available. This is the password created during the initial setup of the controller.
  3. When Home Assistant asks for the password, press and hold the button on the controller until the LED starts flashing to allow client registration.

During registration, Home Assistant generates a client certificate and key and registers them with the controller.

Configuration

To add the Bosch SHC hub to your Home Assistant instance, use this My button:

Bosch SHC can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Bosch SHC.

  • Follow the instructions on screen to complete the setup.

Supported functionality

Binary sensors

The binary sensor platform allows you to monitor the states of your shutter contact and battery sensors. Binary sensor devices are added for each of the following devices:

  • Shutter Contact
  • Shutter Contact II
  • Battery powered devices

Covers

The cover platform allows you to control shutters, awnings, and blinds.

Shutter Control and Micromodule Shutter Control devices support opening, closing, stopping, and setting the position. Micromodule Blinds additionally support opening, closing, and setting the tilt position.

Event

  • A Motion Detector or Motion Detector II gets an event entity that fires whenever the device detects motion.
  • A Smoke Detector gets an event entity that fires whenever its alarm state changes.
  • A Smoke Detection System gets an event entity that fires whenever its alarm state changes: Idle (alarm_off), Alarm (alarm_on), or Alarm muted (alarm_muted).

Number

The number platform lets you fine-tune numeric device settings:

  • A Micromodule Relay configured in impulse-switch mode gets a Pulse length value, controlling how long the relay stays closed for each trigger.
  • A Shutter Contact II gets a Break function timeout value (1 to 15 minutes), controlling how long an active break function stays in effect before it expires automatically. It has no effect while the break function is set to never expire.
  • A Smart Plug or Smart Plug Compact that supports energy-saving mode gets an Energy-saving power threshold value (0 to 3680 W), controlling the power draw below which the plug switches off automatically.

Select

The select platform lets you choose between a set of predefined options. An Outdoor Siren gets a Siren volume select entity, letting you choose between reduced, medium, or loud.

Sensors

The sensor platform allows you to monitor the states of your temperature, humidity, purity, air quality, power, energy, and valve motor status sensors. Sensor devices are added for each of the following devices:

  • Thermostat
  • Wall Thermostat
  • Twinguard
  • Smart Plug
  • Smart Plug Compact
  • Light Switch
  • Micromodule Shutter Control
  • Micromodule Blinds

Smart Plug Compact devices also provide a communication quality sensor. Thermostats provide diagnostic valve position and valve motor status sensors; the legacy raw valve position sensor is disabled by default because the valve entity provides the position directly.

In addition, a single Open doors and windows sensor is added for the whole home, not tied to a specific device. Its state is the total number of currently open doors, windows, and other openings, with the name of each open item listed in the open_doors, open_windows, and open_others state attributes.

Switches

The switch platform allows you to control your outlets, light switches, and select camera functions. Switches are added for each of the following devices:

  • Light Switch
  • Smart Plug
  • Smart Plug Compact
  • Camera Eyes
  • Camera 360
  • Camera Outdoor Gen2

Some devices also get an additional, device-specific switch. These are configuration entities, so they appear under the device’s configuration controls rather than with the main controls:

  • Camera Eyes: a Camera light switch to turn its built-in light on or off
  • Outdoor Camera Gen2: Ambient light and Front light switches to turn its ambient light and front light on or off
  • Motion Detector II: Pet immunity, and Sabotage detection
  • Motion Detector II that supports it: Automatic sensitivity
  • Door/Window Contact II Plus: Vibration detection
  • Shutter Contact II: two Break function switches, one to exclude the contact from the intrusion alarm, and one to prevent that exclusion from expiring automatically
  • Smoke Detector II: Intrusion alarm, to sound or clear its own alarm
  • Thermostat that supports silent operation: Whisper mode
  • Thermostat Gen2 or Room Thermostat 2 that supports this feature: Humidity warning
  • Smart Plug or Smart Plug Compact that supports energy-saving mode: Energy-saving mode
  • Twinguard that supports this feature: Heartbeat, which enables or disables its nightly self-test notification
  • Micromodule Relay that supports switch configuration: Swap inputs and Swap outputs

Valve

The valve platform provides a diagnostic entity showing the current valve position of each Thermostat, from fully closed (0%) to fully open (100%).

Bosch SHC automation examples

Tip

You don’t need to edit YAML to use these examples. Copy a YAML snippet from this page, open the visual automation editor in Home Assistant, and press Ctrl+V (or Cmd+V on Mac). Home Assistant automatically converts the pasted YAML into the visual editor format, whether it’s a full automation, a single trigger, a condition, or an action.

Automation: Notify when a door or window is left open

Get a reminder if a shutter contact stays open for too long, so an open window doesn’t go unnoticed.

  • Trigger: State changed
    • Entity: Front door (binary sensor)
    • To: On
    • For: 00:10:00
  • Action: Send a notification message
    • Target: My Device (notify.my_device)
    • Message: The front door has been open for 10 minutes.
YAML example for an open-door reminder
AutomationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more] 
alias: "Front door left open"
triggers:
  - trigger: state
    entity_id: binary_sensor.front_door
    to: "on"
    for:
      minutes: 10
actions:
  - action: notify.send_message
    target:
      entity_id: notify.my_device
    data:
      message: "The front door has been open for 10 minutes."

Automation: Close covers automatically at sunset

Combine the cover platform with a sun trigger to close your shutters as it gets dark.

  • Trigger: Sunset
  • Action: Close cover
    • Target: Living room shutter
YAML example for closing covers at sunset
AutomationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more] 
alias: "Close shutters at sunset"
triggers:
  - trigger: sun
    event: sunset
actions:
  - action: cover.close_cover
    target:
      entity_id: cover.living_room_shutter

Data updates

The Bosch Smart Home Controller pushes state changes to Home Assistant as they happen, over a persistent local connection. This means entities update in near real time and Home Assistant doesn’t need to regularly check in with the controller for most of them.

Camera-related switches and the Open doors and windows sensor are the exception: they’re checked periodically instead, since the controller doesn’t push their state changes.

If the connection to the controller drops, for example because of a network hiccup or a controller restart, Home Assistant reconnects automatically once the controller is reachable again.

Known limitations

  • The Bosch Smart Home Controller communicates with Home Assistant over the local network. The controller itself does not need to be reachable from the internet.
  • Devices you pair with the controller after setting up the integration don’t appear automatically. Go to Settings > Devices & services, select Bosch SHC, and select Reload to pick up new devices.
  • If authentication with the controller fails, Home Assistant starts reauthentication so the controller can be registered again. If the controller’s IP address changes and it is discovered through Zeroconf, Home Assistant updates the configured address automatically.

Troubleshooting

The integration can’t connect to the controller

Symptom

Setup reports that Home Assistant cannot connect to the controller.

Description

Home Assistant cannot establish a connection to the Bosch Smart Home Controller over the local network.

Resolution

Make sure the controller is powered on and reachable from your Home Assistant instance over the local network. If you entered the address manually, verify that the IP address or hostname is correct.

Setup fails with a pairing error

Symptom

Setup reports a pairing or registration error after entering the system password.

Description

The Bosch Smart Home Controller only accepts new client registrations while it is in pairing mode.

Resolution

Press and hold the button on the controller until the LED starts flashing, then try again.

Setup fails with an authentication error

Symptom

Setup reports that authentication failed after entering the system password.

Description

Home Assistant could not authenticate with the Bosch Smart Home Controller using the provided credentials.

Resolution

Verify that you entered the system password configured for the Bosch Smart Home Controller. If an existing integration needs new credentials, follow the reauthentication flow shown by Home Assistant to register the controller again.

Removing the integration

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.

Removing the integration doesn’t delete the client certificate and key files it created on your Home Assistant instance. If you no longer need them, remove them from the bosch_shc folder in your Home Assistant configuration directory.