diff --git a/apps/matter-server/README.md b/apps/matter-server/README.md
index 2f6c9b9..e0c8d37 100644
--- a/apps/matter-server/README.md
+++ b/apps/matter-server/README.md
@@ -23,6 +23,15 @@ does not expose `accept_ra_rt_info_max_plen` in this container kernel.
 The Kubernetes node uses systemd-networkd's router advertisement handling;
 its kernel `accept_ra=0` does not mean IPv6 route learning is disabled.
 
+BLE proxy commissioning is enabled. Home Assistant's Matter integration
+connects to the server's `/ble` endpoint and supplies its Bluetooth adapters
+or active ESPHome proxies, allowing commissioning without Google Play services.
+The upstream prerequisites for ESPHome proxies are ESPHome 2026.5 or newer
+and ESP-IDF 6.0.1 or newer. Verify the proxy firmware and Bluetooth range
+before using this path; merely seeing BLE advertisements is not sufficient.
+The controller must have the preferred Thread dataset before commissioning.
+Devices still require their own Matter QR/manual setup code and pairing mode.
+
 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
diff --git a/apps/matter-server/values.yaml b/apps/matter-server/values.yaml
index 96440da..f31628d 100644
--- a/apps/matter-server/values.yaml
+++ b/apps/matter-server/values.yaml
@@ -1,4 +1,7 @@
 fullnameOverride: matter-server
+bluetoothCommissioning:
+  enabled: true
+  mode: proxy
 networkInterface: enp1s0
 listenAddresses:
   - 192.168.0.3