Describe the issue you are experiencing
When I try and run the Matter Server with the "Enable BLE proxy" option enabled, it crashes with the following log:
usage: matter-server [-h] [--vendorid VENDORID] [--fabricid FABRICID]
[--storage-path STORAGE_PATH] [--port PORT]
[--listen-address LISTEN_ADDRESS] [--log-level LOG_LEVEL]
[--log-level-sdk LOG_LEVEL_SDK] [--log-file LOG_FILE]
[--primary-interface PRIMARY_INTERFACE]
[--paa-root-cert-dir PAA_ROOT_CERT_DIR]
[--enable-test-net-dcl]
[--bluetooth-adapter BLUETOOTH_ADAPTER]
[--log-node-ids LOG_NODE_IDS [LOG_NODE_IDS ...]]
[--ota-provider-dir OTA_PROVIDER_DIR]
[--disable-server-interactions]
matter-server: error: unrecognized arguments: --ble-proxy
[20:12:31] WARNING: matter-server service exited with code 2 (by signal 0).
Reinstalling the App fresh doesn't help, whether I delete the App data or not, it just un-pairs all my Matter devices with no warning. Good job I had a backup.
What type of installation are you running?
Home Assistant OS
Which operating system are you running on?
Home Assistant Operating System
Which app are you reporting an issue with?
Matter Server
What is the version of the app?
8.5.0
Steps to reproduce the issue
- Install the Addon
- Enable BLE Proxy
- Observe the faliure to start
System Health information
System Information
| version |
core-2026.6.2 |
| installation_type |
Home Assistant OS |
| dev |
false |
| hassio |
true |
| docker |
true |
| container_arch |
amd64 |
| user |
root |
| virtualenv |
false |
| python_version |
3.14.5 |
| os_name |
Linux |
| os_version |
6.12.85-haos |
| arch |
x86_64 |
| timezone |
Europe/London |
| config_dir |
/config |
Home Assistant Community Store
| GitHub API |
ok |
| GitHub Content |
ok |
| GitHub Web |
ok |
| HACS Data |
ok |
| GitHub API Calls Remaining |
5000 |
| Installed Version |
2.0.5 |
| Stage |
running |
| Available Repositories |
3121 |
| Downloaded Repositories |
4 |
Home Assistant Cloud
| logged_in |
false |
| can_reach_cert_server |
ok |
| can_reach_cloud_auth |
ok |
| can_reach_cloud |
ok |
Home Assistant Supervisor
| host_os |
Home Assistant OS 17.3 |
| update_channel |
stable |
| supervisor_version |
supervisor-2026.05.1 |
| agent_version |
1.8.1 |
| docker_version |
29.3.1 |
| disk_total |
60.3 GB |
| disk_used |
20.3 GB |
| nameservers |
2a02:390:67b7:0:be24:11ff:fecb:a539, 192.168.1.1 |
| healthy |
true |
| supported |
true |
| host_connectivity |
true |
| supervisor_connectivity |
true |
| ntp_synchronized |
true |
| virtualization |
kvm |
| board |
ova |
| supervisor_api |
ok |
| version_api |
ok |
| installed_addons |
Let's Encrypt (6.3.2), Advanced SSH & Web Terminal (23.0.9), Mosquitto broker (6.5.2), Zigbee2MQTT (2.9.0-1), Get HACS (1.3.1), OpenThread Border Router (3.0.1), Whisper (3.1.0), Piper (2.2.2), Everything Presence Zone Configurator (2.2.2), Matter Server (8.5.0) |
Dashboards
| dashboards |
3 |
| resources |
1 |
| views |
1 |
| mode |
storage |
Recorder
| oldest_recorder_run |
23 April 2026 at 21:05 |
| current_recorder_run |
10 June 2026 at 21:11 |
| estimated_db_size |
354.36 MiB |
| database_engine |
sqlite |
| database_version |
3.49.2 |
Anything in the Supervisor logs that might be useful for us?
Anything in the app logs that might be useful for us?
-----------------------------------------------------------
Add-on: Matter Server
Matter WebSocket Server for Home Assistant Matter support.
-----------------------------------------------------------
Add-on version: 8.5.0
You are running the latest version of this add-on.
System: Home Assistant OS 17.3 (amd64 / qemux86-64)
Home Assistant Core: 2026.6.2
Home Assistant Supervisor: 2026.05.1
-----------------------------------------------------------
Please, share the above information when looking for help
or support in, e.g., GitHub, forums or the Discord chat.
-----------------------------------------------------------
s6-rc: info: service banner successfully started
s6-rc: info: service matter-server: starting
s6-rc: info: service matter-server successfully started
s6-rc: info: service legacy-services: starting
[21:13:08] INFO: Starting Matter Server...
s6-rc: info: service legacy-services successfully started
[21:13:09] INFO: Using Python Matter Server
[21:13:09] INFO: Using 'enp6s18' as primary network interface.
[21:13:09] INFO: Successfully send discovery information to Home Assistant.
usage: matter-server [-h] [--vendorid VENDORID] [--fabricid FABRICID]
[--storage-path STORAGE_PATH] [--port PORT]
[--listen-address LISTEN_ADDRESS] [--log-level LOG_LEVEL]
[--log-level-sdk LOG_LEVEL_SDK] [--log-file LOG_FILE]
[--primary-interface PRIMARY_INTERFACE]
[--paa-root-cert-dir PAA_ROOT_CERT_DIR]
[--enable-test-net-dcl]
[--bluetooth-adapter BLUETOOTH_ADAPTER]
[--log-node-ids LOG_NODE_IDS [LOG_NODE_IDS ...]]
[--ota-provider-dir OTA_PROVIDER_DIR]
[--disable-server-interactions]
matter-server: error: unrecognized arguments: --ble-proxy
[20:13:11] WARNING: matter-server service exited with code 2 (by signal 0).
s6-rc: info: service legacy-services: stopping
s6-rc: info: service legacy-services successfully stopped
s6-rc: info: service legacy-cont-init: stopping
s6-rc: info: service matter-server: stopping
s6-rc: info: service matter-server successfully stopped
s6-rc: info: service banner: stopping
s6-rc: info: service banner successfully stopped
s6-rc: info: service legacy-cont-init successfully stopped
s6-rc: info: service fix-attrs: stopping
s6-rc: info: service fix-attrs successfully stopped
s6-rc: info: service s6rc-oneshot-runner: stopping
s6-rc: info: service s6rc-oneshot-runner successfully stopped
Additional information
No response
Describe the issue you are experiencing
When I try and run the Matter Server with the "Enable BLE proxy" option enabled, it crashes with the following log:
Reinstalling the App fresh doesn't help, whether I delete the App data or not, it just un-pairs all my Matter devices with no warning. Good job I had a backup.
What type of installation are you running?
Home Assistant OS
Which operating system are you running on?
Home Assistant Operating System
Which app are you reporting an issue with?
Matter Server
What is the version of the app?
8.5.0
Steps to reproduce the issue
System Health information
System Information
Home Assistant Community Store
Home Assistant Cloud
Home Assistant Supervisor
Dashboards
Recorder
Anything in the Supervisor logs that might be useful for us?
Anything in the app logs that might be useful for us?
----------------------------------------------------------- Add-on: Matter Server Matter WebSocket Server for Home Assistant Matter support. ----------------------------------------------------------- Add-on version: 8.5.0 You are running the latest version of this add-on. System: Home Assistant OS 17.3 (amd64 / qemux86-64) Home Assistant Core: 2026.6.2 Home Assistant Supervisor: 2026.05.1 ----------------------------------------------------------- Please, share the above information when looking for help or support in, e.g., GitHub, forums or the Discord chat. ----------------------------------------------------------- s6-rc: info: service banner successfully started s6-rc: info: service matter-server: starting s6-rc: info: service matter-server successfully started s6-rc: info: service legacy-services: starting [21:13:08] INFO: Starting Matter Server... s6-rc: info: service legacy-services successfully started [21:13:09] INFO: Using Python Matter Server [21:13:09] INFO: Using 'enp6s18' as primary network interface. [21:13:09] INFO: Successfully send discovery information to Home Assistant. usage: matter-server [-h] [--vendorid VENDORID] [--fabricid FABRICID] [--storage-path STORAGE_PATH] [--port PORT] [--listen-address LISTEN_ADDRESS] [--log-level LOG_LEVEL] [--log-level-sdk LOG_LEVEL_SDK] [--log-file LOG_FILE] [--primary-interface PRIMARY_INTERFACE] [--paa-root-cert-dir PAA_ROOT_CERT_DIR] [--enable-test-net-dcl] [--bluetooth-adapter BLUETOOTH_ADAPTER] [--log-node-ids LOG_NODE_IDS [LOG_NODE_IDS ...]] [--ota-provider-dir OTA_PROVIDER_DIR] [--disable-server-interactions] matter-server: error: unrecognized arguments: --ble-proxy [20:13:11] WARNING: matter-server service exited with code 2 (by signal 0). s6-rc: info: service legacy-services: stopping s6-rc: info: service legacy-services successfully stopped s6-rc: info: service legacy-cont-init: stopping s6-rc: info: service matter-server: stopping s6-rc: info: service matter-server successfully stopped s6-rc: info: service banner: stopping s6-rc: info: service banner successfully stopped s6-rc: info: service legacy-cont-init successfully stopped s6-rc: info: service fix-attrs: stopping s6-rc: info: service fix-attrs successfully stopped s6-rc: info: service s6rc-oneshot-runner: stopping s6-rc: info: service s6rc-oneshot-runner successfully stoppedAdditional information
No response