Skip to content

Matter Server 8.5.0: Enabling BLE Proxy Causes Crash on Start #4649

@thingythekid

Description

@thingythekid

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

  1. Install the Addon
  2. Enable BLE Proxy
  3. 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Priority

    None yet

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions