Add matter integration (#24353)

Co-authored-by: Marcel van der Veldt <m.vanderveldt@outlook.com>
Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
Martin Hjelmare 2022-12-07 17:51:13 +01:00 committed by GitHub
parent 4371d017e4
commit d10964c07a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -0,0 +1,52 @@
---
title: Matter
description: Instructions on how to integrate Matter with Home Assistant.
ha_category:
- Binary Sensor
- Light
- Sensor
- Switch
ha_release: '2022.12'
ha_iot_class: Local Push
ha_config_flow: true
ha_codeowners:
- '@marcelveldt'
- '@MartinHjelmare'
ha_domain: matter
ha_platforms:
- binary_sensor
- light
- sensor
- switch
ha_integration_type: integration
---
This integration allows you to communicate with and control Matter devices on your local WiFi or Thread network.
<p class='note'>
Both Matter and the implementation within Home Assistant are in early (v1) state and features may be missing or could be improved.
</p>
{% include integrations/config_flow.md %}
If you run Home Assistant Container, Home Assistant Core, or you dont want to use the built-in Matter Server add-on, please see the [advanced installation instructions](#advanced-installation-instructions).
## Advanced installation instructions
If you are using Home Assistant Container, Home Assistant Core, or you don't want to use the built-in Matter Server add-on, you will need to run the Matter Server yourself, to which the Matter integration will connect.
### Running Matter Server
This application provides the connection between your Matter network (called Fabric in technical terms) and Home Assistant. The Home Assistant Matter integration connects to this server via a websocket connection. You need to run the Matter Server before you can use the integration.
There are multiple ways to run the server:
**Option 1: The official Matter Server add-on, as described above**
_This option is only available for Home Assistant OS (the recommended installation type) and Home Assistant Supervised installations._
**Option 2: Run the Matter server yourself**
This option is considered a very advanced setup and only for experienced users. You can find instructions on how to run the Matter Server in the [project repository](https://github.com/home-assistant-libs/python-matter-server).