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.
Outcome
Section titled “Outcome”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.
Topology
Section titled “Topology”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-FiVLAN 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.
Before changing anything
Section titled “Before changing anything”cat /etc/openwrt_releaseuci show networkuci 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.
1. Put the ONT in bridge mode
Section titled “1. Put the ONT in bridge mode”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.
2. Carry VLANs to OpenWrt
Section titled “2. Carry VLANs to OpenWrt”The example assumes a DSA device with a wan port and two tagged VLANs. Check names with ip -d link show.
uci set network.brwan=deviceuci set network.brwan.name='br-wan'uci set network.brwan.type='bridge'uci add_list network.brwan.ports='wan'
uci add network bridge-vlanuci 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-vlanuci 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 reloadwan:tmeans 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:
bridge vlan showip -d link show br-wan3. Configure PPPoE
Section titled “3. Configure PPPoE”uci set network.wan=interfaceuci 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 reloadNotes:
1492is common for PPPoE over Ethernet; do not guess if the ISP requires another value;keepalivereconnects 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.
4. Verify layer by layer
Section titled “4. Verify layer by layer”ip -d link show br-wanbridge vlan showubus call network.interface.wan statusifstatus wanlogread -fip addr showip routeping -c 2 1.1.1.1nslookup openwrt.orgLook 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”.
5. IPTV / single-line reuse
Section titled “5. IPTV / single-line reuse”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.
Failure matrix
Section titled “Failure matrix”| 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 |
Recovery
Section titled “Recovery”- Use console/serial if the network path is gone.
- Restore the backed-up OpenWrt config.
- Revert the ONT to router mode or restore the old router.
- Reconnect the old WAN first; change one variable at a time.
- If you cannot recover, use failsafe and re-apply the backup, not a blind factory reset.
E1 status
Section titled “E1 status”- 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
Independent OpenWrt notes. Every page states the firmware, device, package manager and way back.
Icons: Solar by 480 Design, CC BY 4.0