PPP

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Installation

PPP (Point-to-Point Protocol) allows multiple transports, eg. PPPoE is PPP over Ethernet.

PPPoE

apk add ppp-pppoe

Configure PPP

PPP peer file

Such file is usually located as /etc/ppp/peers/<isp>. See pppd(8) for all possible options.

PPPoE

This example peer file is based on Debian's peers-pppoe extra file. See that pppoe.so plugin as eth0 as device defined.

user "myusername@realm"
plugin pppoe.so eth0
noipdefault
usepeerdns
defaultroute
persist
noauth

Note that if you have a version of ppp older than 2.4.9, the pppoe.so plugin is named rp-pppoe.so.

Authentication

CHAP authentication is most used one but there are other ones, see pppd(8).

/etc/ppp/chap-secrets

# Secrets for authentication using CHAP
# client	server	secret			IP addresses
"myusername@realm"	        *	"<your password>"

Kernel modules

PPPoE

pppoe must be present in /etc/modules when using PPPoE.

ifupdown-ng intergration

To use /etc/network/interfaces with a ppp defintion automatically, ifupdown-ng-ppp package must be installed.

apk add ifupdown-ng-ppp

Example for PPP configuration in /etc/network/interfaces, see interfaces-ppp(5) for more info.

auto eth0
iface eth0 up

auto ppp0
iface ppp0
	ppp-provider isp

Tips

pppoeconf

Debian created pppoeconf tool which helps configuring PPPoE. First some utils have to be installed.

apk add ppp-pppoe newt gettext sed

wget https://sources.debian.org/data/main/p/pppoeconf/1.21%2Bnmu2/pppoeconf

chmod +x ./pppoeconf && ./pppoeconf