Skip to content

ONT bridge, PPPoE and VLAN: from dial failure to a working WAN

Status: E1 documentation. ONT menus, VLAN IDs, PPPoE credentials and IPTV behavior are ISP-specific. The examples use placeholders; do not treat them as a verified configuration.

After this page you should be able to:

  • decide whether the ONT should stay in router mode or be bridged;
  • carry internet and IPTV VLANs to OpenWrt on one cable;
  • configure PPPoE with the right device, MTU and IPv6 options;
  • tell the difference between PADO timeout, authentication failure, VLAN mismatch and DNS/MTU failure;
  • recover if the change locks you out.
ISP line
│
▼
ONT (bridge)
│ one cable, tagged VLANs (example: 41 internet, 45 IPTV)
▼
OpenWrt WAN port
├── br-wan.41 → PPPoE → internet
└── br-wan.45 → IPTV (DHCP/static, IGMP proxy as needed)
│
▼
LAN / Wi-Fi

VLAN IDs are examples. The real IDs must come from the ISP, the ONT’s configuration, or the old router’s WAN settings. Do not copy 41/45 blindly.

Router shellRecord the working state and a way back
Terminal window
cat /etc/openwrt_release
uci show network
uci show firewall | grep -E "zone|forwarding"
ip -d link show
  • Record the old router’s WAN mode, VLAN ID, PPPoE username, MTU and MAC if the ISP binds it.
  • Back up the OpenWrt config and the ONT configuration if the ISP/ONT allows export.
  • Keep a serial/console path or a second known-good router.
  • Do not change the ONT and OpenWrt at the same time; one change at a time.

ExpectedYou can restore the old router/ONT configuration and still reach a console.

The ONT menu varies by vendor and ISP. The goal is:

  • the ONT stops doing PPPoE/routing/DHCP for the internet;
  • the internet VLAN is passed through to the OpenWrt WAN port;
  • IPTV, if present, keeps its own VLAN;
  • management access to the ONT is still known.

Do not publish a universal “click these ONT menus” recipe. Record the vendor/model/firmware and the exact menu path for your line. If the ISP controls the ONT, ask them to bridge it or provide the VLAN/PPPoE parameters.

The example assumes a DSA device with a wan port and two tagged VLANs. Check names with ip -d link show.

Terminal window
uci set network.brwan=device
uci set network.brwan.name='br-wan'
uci set network.brwan.type='bridge'
uci add_list network.brwan.ports='wan'
uci add network bridge-vlan
uci set network.@bridge-vlan[-1].device='br-wan'
uci set network.@bridge-vlan[-1].vlan='41'
uci add_list network.@bridge-vlan[-1].ports='wan:t'
uci add network bridge-vlan
uci set network.@bridge-vlan[-1].device='br-wan'
uci set network.@bridge-vlan[-1].vlan='45'
uci add_list network.@bridge-vlan[-1].ports='wan:t'
uci commit network
/etc/init.d/network reload
  • wan:t means tagged on the WAN port;
  • the ONT/switch peer must tag the same VLANs;
  • on non-DSA/swconfig devices the syntax differs; do not paste DSA syntax there;
  • if the WAN port is already a bridge member, do not create a second conflicting bridge.

Verify:

Terminal window
bridge vlan show
ip -d link show br-wan
Terminal window
uci set network.wan=interface
uci set network.wan.proto='pppoe'
uci set network.wan.device='br-wan.41'
uci set network.wan.username='<isp-user>'
uci set network.wan.password='<isp-password>'
uci set network.wan.mtu='1492'
uci set network.wan.keepalive='5 5'
uci set network.wan.ipv6='1'
uci commit network
/etc/init.d/network reload

Notes:

  • 1492 is common for PPPoE over Ethernet; do not guess if the ISP requires another value;
  • keepalive reconnects after a dropped session;
  • ipv6='1' requests IPv6; the ISP must delegate a prefix/RA;
  • if the ISP binds MAC, clone the old router’s WAN MAC only when you understand the policy;
  • do not put the PPPoE interface on an untagged WAN device if the ONT sends a tagged VLAN.
Router shellCheck link, VLAN, PPPoE session and route
Terminal window
ip -d link show br-wan
bridge vlan show
ubus call network.interface.wan status
ifstatus wan
logread -f
ip addr show
ip route
ping -c 2 1.1.1.1
nslookup openwrt.org

Look for:

  • PADO timeout / no PPPoE discovery → ONT bridge, VLAN, cable, ISP port, MAC binding;
  • authentication failure → username/password/service name;
  • PPPoE up but no internet → DNS, route, firewall/NAT, MTU;
  • IPv6 missing → prefix delegation/RA/DHCPv6, not always the same as IPv4.

ExpectedYou know which layer failed, not just “no internet”.

If IPTV shares the same cable:

  • put the IPTV VLAN on its own interface (for example br-wan.45);
  • assign it to the correct firewall zone; do not blindly put it in WAN if it needs LAN/IGMP treatment;
  • IGMP proxy/snooping is a separate service; installing it is not the same as VLAN tagging;
  • do not mix IPTV and internet in one untagged bridge;
  • IPTV source lists and decryption are out of scope; use only your own legitimate service.

Cross-link: DSA VLAN basics are in 023; guest Wi-Fi/VLAN is in 024.

Symptom Check first Common cause
PADO timeout ONT bridge, VLAN ID, cable, ISP port VLAN missing/wrong; ONT still routing; MAC binding
PPPoE auth failed username/password/service typo; ISP account bound to old MAC; wrong service name
PPPoE up, no internet DNS, route, firewall/NAT, MTU DNS not pushed; no default route; MSS/MTU black hole
Internet works, IPTV not IPTV VLAN, IGMP, firewall zone IPTV VLAN not tagged; IGMP proxy missing; wrong zone
IPv6 missing WAN6, prefix delegation, RA/DHCPv6 ISP does not delegate; firewall; prefix not requested
Web UI unreachable after change LAN IP, DHCP, bridge/VLAN LAN moved; DHCP disabled; VLAN cut the management path
  1. Use console/serial if the network path is gone.
  2. Restore the backed-up OpenWrt config.
  3. Revert the ONT to router mode or restore the old router.
  4. Reconnect the old WAN first; change one variable at a time.
  5. If you cannot recover, use failsafe and re-apply the backup, not a blind factory reset.
  • This page is documentation-only: no real ONT, ISP line or IPTV service was tested.
  • VLAN IDs, ONT menus, PPPoE service names and IPv6 behavior vary by ISP; record your own values.
  • Promote to E2 only after a reproducible lab or line test; promote key “works on this ISP” claims to E3 only with real hardware/line evidence.
  • No independent reviewer; do not treat this page as a guarantee for a specific ISP.

Sources

Router.Homes

Independent OpenWrt notes. Every page states the firmware, device, package manager and way back.

Icons: Solar by 480 Design, CC BY 4.0