matter_server: add ble_proxy option

[Apollon77]

Proposed change

Add a `ble_proxy` boolean option to the Matter Server add-on. When
enabled, the add-on starts the matter-server with `--ble-proxy`
instead of the local-adapter `--bluetooth-adapter` flag. The
matter-server then exposes a `/ble` WebSocket endpoint that Home
Assistant's Matter integration connects to and bridges through HA's
bluetooth component (including ESPHome BLE proxies).

This is the add-on side of a three-repo change:

• matter-server: feat(ble-proxy): end-to-end BLE proxy commissioning + matter-ble-proxy Python lib matter-js/matterjs-server#662
• HA core Matter integration:
  Add BLE proxy support to matter integration core#171384
• (this PR) matter-server add-on

The two BLE-related options are mutually exclusive at the
matter-server level — `--ble-proxy` takes precedence if both are
set, with a warning logged. The add-on docs note the conflict.

Type of change

• Dependency upgrade
• Bugfix (non-breaking change which fixes an issue)
• New integration (thank you!)
• New feature (which adds functionality to an existing add-on)
• Breaking change

Test plan

• Add-on builds successfully with the new `ble_proxy` option.
• Setting `ble_proxy: true` passes `--ble-proxy` to the
  matter-server start command (verified in `s6-rc.d/.../run`).
• End-to-end commissioning of a Matter device over BLE through
  HA's bluetooth integration, with matter-server in `--ble-proxy`
  mode.

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features
  • Added ble_proxy configuration option (v8.5.0) to expose Matter Server's BLE proxy endpoint for Home Assistant's Matter integration. Requires Home Assistant 2026.06+ and Beta Matter Server ≥ 0.7.1. This setting is mutually exclusive with Bluetooth Adapter ID.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: b3dfeade-19f9-4275-b351-b21ec6c6d84f

📥 Commits

Reviewing files that changed from the base of the PR and between 1c1a052 and a856ced.

📒 Files selected for processing (4)

• matter_server/CHANGELOG.md
• matter_server/config.yaml
• matter_server/rootfs/etc/s6-overlay/s6-rc.d/matter-server/run
• matter_server/translations/en.yaml

---

📝 Walkthrough

Walkthrough

This pull request introduces a new ble_proxy configuration option for the Matter Server add-on that exposes the server's BLE proxy endpoint for Home Assistant's Matter integration. The option is optional, requires specific Home Assistant (2026.06+) and Beta Matter Server (≥0.7.1) versions, and is mutually exclusive with the local bluetooth_adapter_id setting.

Changes

BLE Proxy Feature

Layer / File(s)	Summary
Configuration schema and user-facing labels matter_server/config.yaml, matter_server/translations/en.yaml	Version field bumped to 8.5.0, new optional ble_proxy boolean schema field added, and translated configuration labels describe the option with version requirements and mutual exclusivity with Bluetooth Adapter ID.
Startup script conditional handling matter_server/rootfs/etc/s6-overlay/s6-rc.d/matter-server/run	Script checks for ble_proxy and appends --ble-proxy argument when enabled, warns if bluetooth_adapter_id is also set, and preserves existing --bluetooth-adapter logic when ble_proxy is not enabled.
Release documentation matter_server/CHANGELOG.md	Changelog entry for 8.5.0 documents the new ble_proxy option, its Home Assistant integration purpose, required versions, and exclusivity with bluetooth_adapter_id.

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately and concisely summarizes the main change: adding a new ble_proxy option to the Matter Server add-on configuration.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}