Skip to content

Instructions for creating a network bridge don't work with current Trixie OS release #4282

@Bucking-Horn

Description

@Bucking-Horn

I'm trying to follow instructions from

https://www.raspberrypi.com/documentation/computers/configuration.html#use-your-raspberry-pi-as-a-network-bridge

Image

When trying to run those commands on a headless Zero W with a USB ethernet adpater, this fails at the final steps when bringing up the interfaces as follows (perhaps because netplan is interfering?):

~ $ uname -a
Linux rpi-zero-1 6.12.47+rpt-rpi-v6 #1 Raspbian 1:6.12.47-1+rpt1 (2025-09-16) armv6l GNU/Linux
~ $ sudo nmcli connection add type bridge con-name 'Bridge' ifname bridge0
Connection 'Bridge' (713987fb-0e22-4d13-8004-7857d952cdd4) successfully added.

~ $ sudo nmcli connection add type ethernet slave-type bridge \
    con-name 'Ethernet' ifname eth0 master bridge0
Connection 'Ethernet' (02f73742-6633-4748-8bcd-76a68e0d8b9e) successfully added.

~ $ sudo nmcli connection add con-name 'Hotspot' \
    ifname wlan0 type wifi slave-type bridge master bridge0 \
    wifi.mode ap wifi.ssid my-wifi_optout_nomap wifi-sec.key-mgmt wpa-psk \
    wifi-sec.proto rsn wifi-sec.pairwise ccmp \
    wifi-sec.psk 'blankblankblank'
Connection 'Hotspot' (f8706df4-e29a-443a-827f-e69b8a08fd8a) successfully added.

~ $ sudo nmcli connection up Bridge; sudo nmcli connection up Hotspot
Connection successfully activated (controller waiting for ports) (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/5)
Error: Connection activation failed: No suitable device found for this connection (device eth0 not available because profile is not compatible with device (mismatching interface name)).

As netplan seems to have become 'the primary source of truth for for networking on Raspberry Pi OS', the documentation should probably be adjusted to target netplan configuration options instead of NetworkManager.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions