Matter Server: --primary-interface not recognizing VLAN

[mwolter805]

Describe the issue you are experiencing

Hello, I am having an issue where the matter server is not honoring the "--primary-interface enp0s31f6.21" extra Matter Server argument. .21 is the vlan I would like the matter server to use as it's primary interface.

The hub I wish to connect to via Matter is not trusted and therefore placed on a vlan isolated from the internet and also isolated other vlans. I have added a vlan to HA for the same vlan as the untrusted hub. I can ping the untrusted hub on its IPv6 link-local address, so I know HA has connectivity to it through this vlan. However when attempting to add the hub to the matter server it cannot connect. Reviewing the matter server logs I see the following

[17:13:25] INFO: Using 'enp0s31f6' as primary network interface. and not enp0s31f6.21

What type of installation are you running?

Home Assistant OS

Which operating system are you running on?

Home Assistant Operating System

Which add-on are you reporting an issue with?

Matter Server

What is the version of the add-on?

8.0

Steps to reproduce the issue

1. Add --primary-interface enp0s31f6.21 to the Extra Matter Server arguments
2. Restart and review the logs. ...

System Health information

System Information

version	core-2025.5.2
installation_type	Home Assistant OS
dev	false
hassio	true
docker	true
user	root
virtualenv	false
python_version	3.13.3
os_name	Linux
os_version	6.12.23-haos
arch	x86_64
timezone	America/Los_Angeles
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	1789
Downloaded Repositories	33

Home Assistant Cloud

logged_in	true
subscription_expiration	February 17, 2026 at 4:00 PM
relayer_connected	true
relayer_region	us-east-1
remote_enabled	true
remote_connected	true
alexa_enabled	false
google_enabled	false
cloud_ice_servers_enabled	true
remote_server	us-east-1-7.ui.nabu.casa
certificate_status	ready
instance_id	0fd36e6e6c524f25bd11489ed0bd2ce0
can_reach_cert_server	ok
can_reach_cloud_auth	ok
can_reach_cloud	ok

Home Assistant Supervisor

host_os	Home Assistant OS 15.2
update_channel	stable
supervisor_version	supervisor-2025.05.1
agent_version	1.7.2
docker_version	28.0.4
disk_total	1833.1 GB
disk_used	71.6 GB
healthy	true
supported	true
host_connectivity	true
supervisor_connectivity	true
ntp_synchronized	true
virtualization
board	generic-x86-64
supervisor_api	ok
version_api	ok
installed_addons	Nginx Proxy Manager (1.0.1), Studio Code Server (5.19.3), Home Assistant Google Drive Backup (0.112.1), Advanced SSH & Web Terminal (20.0.2), Portainer (2.30.0), Uptime Kuma (0.13.0), Z-Wave JS UI (4.3.1), Tailscale (0.25.0), chrony (5.1.0), Mosquitto broker (6.5.1), Matter Server (8.0.0), ESPHome Device Builder (2025.4.2), Node-RED (19.0.2), Zigbee2MQTT (2.3.0-1), Scrutiny (v0.8.1-9)

Dashboards

dashboards	2
resources	20
views	11
mode	storage

Network Configuration

adapters	lo (disabled), enp0s31f6 (enabled, default, auto), enp0s31f6.21 (enabled), hassio (disabled), docker0 (disabled), vethf946d93 (disabled), veth5e66586 (disabled), veth8c11381 (disabled), veth1fd5f20 (disabled), vethc8eb6dc (disabled), vethd28843d (disabled), vethbe246e1 (disabled), veth1912c5f (disabled), veth8556871 (disabled)
ipv4_addresses	lo (127.0.0.1/8), enp0s31f6 (10.10.10.21/24), enp0s31f6.21 (10.10.21.21/24), hassio (172.30.32.1/23), docker0 (172.30.232.1/23), vethf946d93 (), veth5e66586 (), veth8c11381 (), veth1fd5f20 (), vethc8eb6dc (), vethd28843d (), vethbe246e1 (), veth1912c5f (), veth8556871 ()
ipv6_addresses	lo (::1/128), enp0s31f6 (fe80::96a8:a55b:f92c:b17e/64), enp0s31f6.21 (fe80::4e59:a567:6043:8cec/64), hassio (fe80::3431:5ff:fe7f:3ff/64), docker0 (fe80::248f:a3ff:fe3a:f12b/64), vethf946d93 (fe80::446c:b2ff:fece:d30b/64), veth5e66586 (fe80::94a9:48ff:feea:7a04/64), veth8c11381 (fe80::54d3:7cff:fe1b:5fa2/64), veth1fd5f20 (fe80::e847:b2ff:fe0c:46d6/64), vethc8eb6dc (fe80::603d:fbff:fec2:203b/64), vethd28843d (fe80::98f9:11ff:fe26:f284/64), vethbe246e1 (fe80::44fa:d9ff:fe85:d205/64), veth1912c5f (fe80::a8e6:46ff:fef5:423f/64), veth8556871 (fe80::7085:53ff:fe81:ade2/64)
announce_addresses	10.10.10.21, fe80::96a8:a55b:f92c:b17e, 10.10.21.21, fe80::4e59:a567:6043:8cec

Recorder

oldest_recorder_run	May 9, 2025 at 10:17 PM
current_recorder_run	May 20, 2025 at 4:52 PM
estimated_db_size	2001.47 MiB
database_engine	sqlite
database_version	3.48.0

Anything in the Supervisor logs that might be useful for us?

Anything in the add-on logs that might be useful for us?

Additional information

No response

[github-actions[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[MagicMicky]

Same here - the option seems ignored.

Found info about this option here: https://community.home-assistant.io/t/home-assistant-cant-add-matter-devices-that-are-in-a-different-vlan/750324/35

Looking a little bit here https://github.com/home-assistant/addons/blob/0fa4437fb075dbb9c126980a67d1a97bfbcd4df1/matter_server/rootfs/etc/s6-overlay/s6-rc.d/matter-server/run#L56-L94C28 It seems that extra args are only used if they don't overwrite some specific args? In this case, primary-interface is constantly fetched from supervisor, no matter if it's specified as an extra arg or not?

Cheers, mickael

[Gunni]

You can see this issue whenever the matter server starts, f.ex:

[22:11:02] INFO: Using 'enp0s18' as primary network interface.
[22:11:02] INFO: Successfully send discovery information to Home Assistant.
Reading symbols from /usr/local/bin/python...
(No debugging symbols found in /usr/local/bin/python)
Starting program: /usr/local/bin/python /usr/local/bin/matter-server --storage-path /data --port 5580 --log-level warning --log-level-sdk detail --primary-interface enp0s18 --paa-root-cert-dir /data/credentials --ota-provider-dir /config/updates --fabricid 2 --vendorid 4939 --listen-address 172.30.32.1 --bluetooth-adapter 0 --primary-interface enp0s19 --primary-interface=enp0s19 --primary-interface enp0s19
...
[1752878179.318715][257:257] CHIP:DL: Got Ethernet interface: enp0s18
[1752878179.318940][257:257] CHIP:DL: Found the primary Ethernet interface:enp0s18

[csuich2]

I took a stab at fixing this here: https://github.com/home-assistant/addons/pull/4092

[github-actions[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.