Page MenuHomeVyOS Platform

WiFi interface configured as station can not be added to bridge
Open, HighPublicBUG


Properly adding a WiFi interface to a bridge requires a lot more steps than adding a simple ethernet interface.

Currently the CLI allows it, but it results in an error:

Architecture:     x86_64
Boot via:         installed image
System type:      Unknown hypervisor guest

Hardware vendor:  QEMU
Hardware model:   Standard PC (Q35 + ICH9, 2009)

Traceback (most recent call last):
  File "/usr/libexec/vyos/conf_mode/", line 139, in <module>
  File "/usr/libexec/vyos/conf_mode/", line 130, in apply
  File "/usr/lib/python3/dist-packages/vyos/ifconfig/", line 244, in update
  File "/usr/lib/python3/dist-packages/vyos/ifconfig/", line 179, in add_port
return self.set_interface('add_port', interface)
  File "/usr/lib/python3/dist-packages/vyos/ifconfig/", line 184, in set_interface
return self._set_command(self.config, name, value)
  File "/usr/lib/python3/dist-packages/vyos/ifconfig/", line 109, in _set_command
return self._commandset[name].get('format', lambda : _)(self._cmd(cmd))
  File "/usr/lib/python3/dist-packages/vyos/ifconfig/", line 51, in _cmd
return cmd(command, self.debug)
  File "/usr/lib/python3/dist-packages/vyos/", line 179, in cmd
raise OSError(code, feedback)
FileNotFoundError: [Errno 2] failed to run command: ip link set dev wlan0 master br0
exit code: 2

cmd 'ip link set dev wlan0 master br0'
returned (out):

returned (err):
Error: Device does not allow enslaving to a bridge.

It's possible to do, but it requires a number of extra steps:


Difficulty level
Unknown (require assessment)
Why the issue appeared?
Will be filled on close
Is it a breaking change?
Unspecified (possibly destroys the router)

Event Timeline

kroy created this task.Fri, Sep 11, 8:16 PM
pasik added a subscriber: pasik.Fri, Sep 11, 9:52 PM
c-po added a subscriber: c-po.EditedSat, Sep 12, 8:52 AM

Which CLI commands did you use to trigger this error?

c-po claimed this task.Sat, Sep 12, 8:53 AM
c-po triaged this task as High priority.
kroy added a comment.Wed, Sep 16, 7:17 PM
set interfaces bridge br0 member interface wlan0

Should be the command

c-po renamed this task from Cannot add WiFi interface to Bridge to WiFi interface configured as station can not be added to bridge.Sat, Sep 19, 8:08 PM