Skip to main content
Version: current

l2tp-client


interface/l2tp-client

Type: Directory

FlagNameDescription
XdisabledWhether an item is disabled.
RrunningWhether the interface is running.
ArgumentTypeDescription
namestringDescriptive name of the interface.
max-mtunumMaximum Transmission Unit. Maximum packet size that the L2TP interface can send without packet fragmentation.
max-mrunumMaximum Receive Unit. Maximum packet size that the L2TP interface can receive without packet fragmentation.
mrrunumMaximum packet size that can be received on the link. If a packet is bigger than tunnel MTU, it is split into multiple packets, allowing full-size IP or Ethernet packets to be sent over the tunnel.
connect-to ( mandatory )address (flags=D46v)Remote address of the L2TP server. If the address is in the VRF table, VRF should be specified, for example, 192.168.88.1@vrf1 .
user ( mandatory )stringUser name used for authentication.
passwordstringPassword used for authentication.
profileenumSpecifies which PPP profile configuration is used when establishing the tunnel.
keepalive-timeoutenum (disabled) { disabled:0 }Keepalive timeout in seconds.
src-addressipAddrSource address used for the L2TP connection.
use-peer-dnsenum (no | yes | exclusively) { no:0, yes:1, exclusively:2 }Whether to use DNS settings from the peer.
use-ipsecbool

When this option is enabled, dynamic IPSec peer configuration and policy (transport mode) is added to encapsulate the L2TP connection into an IPSec tunnel.

Multiple L2tp/ipsec clients behind the same NAT will not work in this mode. To achieve such a scenario, disable use-ipsec and set static policies for clients with enabled tunnel=yes, level=unique settings.

ipsec-secretstringIPsec pre-shared key.
allow-fast-pathboolWhether to allow FastPath processing. Must be disabled if IPsec is used.
add-default-routeboolWhether to add the L2TP remote address as a default route.
default-route-distancenumDistance value applied to the auto-created default route when add-default-route is enabled.
dial-on-demandboolConnects to the L2TP server only when outbound traffic is generated. If enabled, a route with a gateway address from 10.112.112.0/24 network is added while the connection is not established.
allowubit (pap, chap, mschap1, mschap2)Allowed authentication methods.
random-source-portboolWhether to randomize the source port for L2TP connections.
l2tp-proto-versionenum (l2tpv2 | l2tpv3-ip | l2tpv3-udp) { l2tpv2:0, l2tpv3-ip:1, l2tpv3-udp:2 }L2TP protocol version to use.
l2tpv3-circuit-idstringL2TPv3 circuit identifier.
enum (0 | 4-bytes | 8-bytes) { 0:0, 4-bytes:4, 8-bytes:8 }L2TPv3 cookie length.
l2tpv3-digest-hashenum (none | md5 | sha1) { none:99, md5:0, sha1:1 }L2TPv3 digest hash algorithm.