Open Home Foundation Matter Server

The Open Home Foundation Matter Server is an officially certified Software Component to create a Matter controller. It serves as the foundation to provide Matter support to Home Assistant but its universal approach makes it suitable to be used in other projects too.

This project implements a Matter Controller Server over WebSockets using the official Matter (formerly CHIP) SDK as a base and provides both a server and client implementation.

[!IMPORTANT] The Matter Server was rewritten and moved to matterjs-server! 🎉 The version 8.1.2 is the final version of the python-matter-server, libraries, and docker-container. Please migrate to the new server as soon as possible, as the python-matter-server will no longer receive updates or support.

The Open Home Foundation Matter Server software component is funded by Nabu Casa (a member of the CSA) and donated to The Open Home Foundation.

Support

For developers, making use of this component or contributing to it, use the issue tracker within this repository and/or reach out on discord.

For users of Home Assistant, seek support in the official Home Assistant support channels.

• The Home Assistant Community Forum.

• The Home Assistant Discord Chat Server.

• Join the Reddit subreddit in /r/homeassistant.

• If you experience issues using Matter with Home Assistant, please open an issue report in the Home Assistant Core repository.

Please do not create Home Assistant enduser support issues in the issue tracker of this repository.

Development

Want to help out with development, testing, and/or documentation? Great! As both this project and Matter keeps evolving there will be a lot to improve. Reach out to us on discord if you want to help out.

Development documentation

Installation / Running the Matter Server

• Endusers of Home Assistant, refer to the Home Assistant documentation how to run Matter in Home Assistant using the official Matter Server add-on, which is based on this project.

• For running the server and/or client in your development environment, see the Development documentation.

• For running the Matter Server as a standalone docker container, see our instructions here.

[!NOTE] Both Matter and this implementation are in an early state and features are probably missing or could be improved. See our development notes how you can help out, with development and/or testing.