How to Configure PPPoE on OpenWrt

This guide configures PPPoE on OpenWrt after the ISP modem has been placed in bridge mode.

It covers PPPoE without a VLAN. Use it when your ISP does not require a VLAN, or when the modem can set the VLAN ID in its bridge configuration.

If the modem has no VLAN field but the PPPoE connection requires one, use the OpenWrt PPPoE with VLAN guide instead.

---

Log in to OpenWrt and open Network > Interfaces. {{< collapse “Screenshot” >}} {{< /collapse >}}

• Under WAN, click Edit. {{< collapse “Screenshot” >}} {{< /collapse >}}

• In General Settings, set Protocol to PPPoE. {{< collapse “Screenshot” >}} {{< /collapse >}}

Click Switch Protocol. {{< collapse “Screenshot” >}} {{< /collapse >}}

Additional fields will appear:

• Enter the ISP-provided account in PAP/CHAP Username.
• Enter the ISP-provided password in PAP/CHAP Password.

{{< collapse “Screenshot” >}} {{< /collapse >}}

After entering the credentials, click Save, then Save & Apply. {{< collapse “Screenshot” >}} {{< /collapse >}}

If the username and password are correct, WAN will show an IPv4 address and, if available, an IPv6 address. {{< collapse “Screenshot” >}} {{< /collapse >}}

{{< notice “info” >}}

• PPPoE may connect immediately or may take a few minutes.
• If the credentials are correct but PPPoE still fails, check the modem’s bridge configuration, the VLAN required by the ISP, and whether the ISP requires a cloned MAC address. {{< /notice >}}

If you already have a modem and only want OpenWrt to provide Wi-Fi, see the OpenWrt AP Mode guide.

---

Good luck!