Why install Matter Server with Web.Casa?
No manual Docker Compose needed. Web.Casa configures and starts everything.
Caddy auto-provisions SSL certificates. Reverse proxy works out of the box.
Monitoring, backups, updates, logs — manage all apps from one panel.
How to Install
Install Web.Casa first, then one-click install this app from the App Store.
Python Matter Server
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.
The goal of this project is primarily to have Matter support in Home Assistant but its universal approach makes it suitable to be used in other projects too.
Support
Got questions?
You have several options to get them answered:
- 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.
You may also open issues in this repository if you are absolutely sure that your issue is related to the Matter Server component.
Requirements to communicate with Wi-Fi/Ethernet based Matter devices
Make sure you run the container on the host network. The host network interface needs to be in the same network as the Android/iPhone device you are using for commissioning. Matter uses link-local multicast protocols which do not work across different LANs or VLANs.
The host network interface needs IPv6 support enabled.
Requirements to communicate with Thread devices through Thread border routers
For communication through Thread border routers which are not running on the same host as the Matter Controller server to work, IPv6 routing needs to be properly working. IPv6 routing is largely setup automatically through the IPv6 Neighbor Discovery Protocol, specifically the Route Information Options (RIO). However, if IPv6 Neighbor Discovery RIO's are processed, and processed correctly depends on the network management software your system is using. There may be bugs and caveats in processing this Route Information Options.
In general, make sure the kernel option CONFIG_IPV6_ROUTER_PREF is enabled and
that IPv6 forwarding is disabled (sysctl variable net.ipv6.conf.all.forwarding).
If IPv6 forwarding is enabled, the Linux kernel doesn't employ reachability
probing (RFC 4191), which can lead to longer outages (up to 30min) until
network changes are detected.
FAQ
Can I install Matter Server on Web.Casa?
Yes, Matter Server is available in the Web.Casa App Store. You can install it with one click from the Web.Casa panel — no need to manually write Docker Compose files or configure reverse proxies.
How do I install Matter Server on Web.Casa?
First install Web.Casa with curl -fsSL https://get.web.casa | bash, then search for "Matter Server" in the App Store and click install. Web.Casa automatically configures the Docker container, assigns ports, and sets up a Caddy reverse proxy.
What is the default port for Matter Server on Web.Casa?
The default port for Matter Server on Web.Casa is 9997. You can bind it to a custom domain through Web.Casa's Caddy reverse proxy, which automatically provisions HTTPS certificates.
Does Matter Server get automatic HTTPS after installation?
Yes. Web.Casa is built on Caddy, so after installing the app, simply bind a domain and Caddy will automatically provision and renew SSL certificates via Let's Encrypt — no manual configuration needed.
How do I back up Matter Server data?
Web.Casa has a built-in backup plugin that supports automatic backups of Matter Server data to local storage, S3, WebDAV, or SFTP. You can configure scheduled snapshots and retention policies to keep your data safe.
