Files
homelab-gitops/apps/matter-server

Matter Server

The matter-server Argo Application installs the maintained home-assistant-matter-server chart from https://charts.derwitt.dev in default, alongside Home Assistant. Its chart version in bootstrap/matter-server.yaml is the canonical release selection; the upstream chart selects its images.

Home Assistant connects to ws://matter-server.default.svc.cluster.local/ws. The server uses host networking on intel-xeon, with enp1s0 as its primary LAN interface. The MikroTik OTBR remains the Thread border router; Matter Server does not create another Thread network. The WebSocket/dashboard port is LAN-only and has no public ingress.

The chart creates data-matter-server-0, mounted at /data, on the retained rook-cephfs-ec storage class. This contains authoritative Matter fabric keys and device pairing state. Preserve the entire directory and its permissions when restoring, stop the server during a filesystem copy, and never run two controllers against the same data. Restore it to the same claim or an isolated recovery claim before starting a replacement controller. Losing this state can require commissioning every device again.

Backup gap: this new claim is not selected by apps/backup/ yet. Ceph replication and the retained volume are not historical backups. No successful external backup or restore exercise is claimed. Thread credentials on the MikroTik and Home Assistant configuration are separate recovery material.