Cisco Catalyst SD-WAN Network Configuration Guide, Releases 26.x and Later

PDF

Configure PPPoE using templates

Updated: April 24, 2026

Want to summarize with AI?

Log in

Provides instructions for configuring PPPoE sessions using templates, covering step-by-step procedures for streamlined deployment.

To use Cisco SD-WAN Manager templates to configure PPPoE on Cisco IOS XE Catalyst SD-WAN device, you create three feature templates and one device template:

  • Create a VPN-Interface-PPP feature template to configure PPP parameters for the PPP virtual interface.

  • Create a VPN-Interface-PPP-Ethernet feature template to configure a PPPoE-enabled interface.

  • Optionally, create a VPN feature template to modify the default configuration of VPN 0.

  • Create a device template that incorporates the VPN-Interface-PPP, VPN-Interface-PPP-Ethernet, and VPN feature templates.

Follow these steps to configure PPPoE using feature templates.

Procedure

1.

Create a VPN-Interface-PPP feature template to configure PPP parameters for the PPP virtual interface.

  1. From the Cisco SD-WAN Manager menu, choose Configuration > Templates.

  2. Click Feature Templates, and click Add Template.

    In Cisco vManage Release 20.7.1 and earlier releases, Feature Templates is titled Feature.

  3. Choose Cisco IOS XE Catalyst SD-WAN device Cloud or a router model.

  4. Choose the VPN-Interface-PPP template.

  5. In the template, configure the following parameters:

    Table 1.

    Parameter Field

    Procedure

    Template Name

    Enter a name for the template. It can be up to 128 alphanumeric characters.

    Description

    Enter a description for the template. It can be up to 2048 alphanumeric characters.

    Shutdown

    Click No to enable the PPP virtual interface.

    Interface Name

    Enter the number of the PPP interface. It can be from 1 through 31.

    Description (optional)

    Enter a description for the PPP virtual interface.

    Authentication Protocol

    Select either CHAP or PAP to configure one authentication protocol, or select PAP and CHAP to configure both. For CHAP, enter the hostname and password provided by your ISP. For PAP, enter the username and password provided by your ISP. If you are configuring both PAP and CHAP, to use the same username and password for both, click Same Credentials for PAP and CHAP.

    AC Name (optional)

    Select the PPP tab, and in the AC Name field, enter the name of the the name of the access concentrator used by PPPoE to route connections to the Internet.

    IP MTU

    Click Advanced, and in the IP MTU field, ensure that the IP MTU is at least 8 bytes less than the MTU on the physical interface. The maximum MTU for a PPP interface is 1492 bytes. If the PPPoE server does not specify a maximum receive unit (MRU), the MTU value for the PPP interface is used as the MRU.

    Starting from Cisco vManage Release 20.9.1, there is 8 bytes overheads deduced based on the specified IP MTU value when configuration is pushed to the device.

    Save

    To save the feature template, click Save.
2.

Create a VPN-Interface-PPP-Ethernet feature template to enable the PPPoE client on the physical interfaces.

  1. From the Cisco SD-WAN Manager menu, choose Configuration > Templates.

  2. Click Feature Templates, and click Add Template.

    In Cisco vManage Release 20.7.1 and earlier releases, Feature Templates is titled Feature.

  3. Choose Cisco IOS XE Catalyst SD-WAN device Cloud or a router model.

  4. Choose the VPN-Interface-PPP-Ethernet template.

  5. In the template, configure the following parameters:

    Parameter Field

    Procedure

    Template Name

    Enter a name for the template. It can be up to 128 alphanumeric characters.

    Description

    Enter a description for the template. It can be up to 2048 alphanumeric characters.

    Shutdown

    Click No to enable the PPPoE-enabled interface.

    Interface Name

    Enter the name of the physical interface in VPN 0 to associate with the PPP interface.

    Description (optional)

    Enter a description for the PPPoE-enabled interface.

    IP Confguration

    Assign an IP address to the physical interface:

    • To use DHCP, select Dynamic. The default administrative distance of routes learned from DHCP is 1.

    • To configure the IP address directly, enter of the IPv4 address of the interface.

    DHCP Helper (optional)

    Enter up to four IP addresses for DHCP servers in the network.

    Save

    To save the feature template, click Save.
3.

Create a VPN feature template to configure the PPPoE-enabled interface in VPN 0, the transport VPN.

  1. From the Cisco SD-WAN Manager menu, choose Configuration > Templates.

  2. Click Feature Templates, and click Add Template.

    In Cisco vManage Release 20.7.1 and earlier releases, Feature Templates is titled Feature.

  3. Choose Cisco IOS XE Catalyst SD-WAN device Cloud or a router model.

  4. Choose the VPN template.

  5. In the template, configure the following parameters:

    Parameter Field

    Procedure

    Template Name

    Enter a name for the template. It can be up to 128 alphanumeric characters.

    Description

    Enter a description for the template. It can be up to 2048 alphanumeric characters.

    VPN Identifier

    Enter VPN identifier 0.

    Name

    Enter aname for the VPN.

    Other interface parameters

    Configure the desired interface properties.

    Save

    To save the feature template, click Save.
4.

Create a device template that incorporates the VPN-Interface-PPP, VPN-Interface-PPP-Ethernet, and VPN feature templates.

  1. From the Cisco SD-WAN Manager menu, choose Configuration > Templates.

  2. Click Device Templates, and then click Create Template.

    In Cisco vManage Release 20.7.1 and earlier releases, Device Templates is titled Device.

  3. From the Create Template drop-down list, choose From Feature Template.

    From the Device Model drop-down list, choose the type of device for which you are creating the device template.

    Cisco SD-WAN Manager displays the feature templates for the device type you selected. Required templates are indicated with an asterisk (*).

    Enter a name and description for the device template. These fields are mandatory. The template name cannot contain special characters.

  4. In Transport & Management VPN, under VPN 0, from the drop-down list of available templates, select the desired feature template. The list of available templates are the ones that you have previously created.

  5. In Additional VPN 0 Templates, click the plus sign (+) next to VPN Interface PPP.

  6. From VPN-Interface-PPP and VPN-Interface-PPP-Ethernet fields, select the feature templates to use.

  7. To configure multiple PPPoE-enabled interfaces in VPN 0, click the plus sign (+) next to Sub-Templates.

  8. To include additional feature templates in the device template, in the remaining sections, select the feature templates in turn, and from the drop-down list of available templates, select the desired template. The list of available templates are the ones that you have previously created. Ensure that you select templates for all mandatory feature templates and for any desired optional feature templates.

  9. To create the device template, click Create.

5.

Attach a device template to a device.

  1. From the Cisco SD-WAN Manager menu, choose Configuration > Templates.

  2. Click Device Templates, and then click Create Template.

    In Cisco vManage Release 20.7.1 and earlier releases, Device Templates is titled Device.

  3. Choose a template.

  4. Click …, and click Attach Device.

  5. Search for a device or select a device from the Available Device(s) column to the left.

  6. Click the arrow pointing right to move the device to the Selected Device(s) column on the right.

  7. Click Attach.