Adding devices to Home Assistant


Home Assistant will be able to automatically discover many devices and services available on your network.

See the integrations overview page to find installation instructions for your devices and services. Most integration can be fully configured via the user interface these days; however, some older or more complex integrations may need to be configured manually using YAML.

For some of these integrations, every entity needs its own entry in the configuration.yaml file. There are two styles for multiple entity entries:

Style 1: Collect every entity under the “parent”

sensor:
  - platform: mqtt
    state_topic: "home/bedroom/temperature"
    name: "MQTT Sensor 1"
  - platform: mqtt
    state_topic: "home/kitchen/temperature"
    name: "MQTT Sensor 2"
  - platform: rest
    resource: "http://IP_ADDRESS/ENDPOINT"
    name: "Weather"

switch:
  - platform: vera

Style 2: List each entity separately

You need to append numbers or strings to differentiate the entries, as in the example below. The appended number or string must be unique.

sensor bedroom:
  platform: mqtt
  state_topic: "home/bedroom/temperature"
  name: "MQTT Sensor 1"

sensor kitchen:
  platform: mqtt
  state_topic: "home/kitchen/temperature"
  name: "MQTT Sensor 2"

sensor weather:
  platform: rest
  resource: "http://IP_ADDRESS/ENDPOINT"
  name: "Weather"

switch 1:
  platform: vera

switch 2:
  platform: vera

Grouping entities

Once you have several entities set up, it is time to organize them into groups. Each group consists of a name and a list of entity IDs. Entity IDs can be retrieved from the web interface by using the States page in the Developer Tools.

# Example configuration.yaml entry
group:
  living_room:
    entities:
      - light.table_lamp
      - switch.ac
  bedroom:
    entities:
      - light.bedroom
      - media_player.nexus_player

For more details please check the Group page.