Call for Contributions

This section needs improvements, examples and explanations.

Please take a look at the Contributing Guide for our Write Documentation.

VPP IPIP Configuration

VPP IPIP interfaces provide IP-in-IP tunneling with high-performance packet processing. IPIP tunnels encapsulate IP packets within IP packets, creating point-to-point connections across Layer 3 networks.

Basic Configuration

Creating an IPIP Interface

set vpp interfaces ipip <ipipN>

Create an IPIP interface where <ipipN> follows the naming convention ipip1, ipip2, etc.

set vpp interfaces ipip <ipipN> remote <address>

Set the tunnel remote endpoint address. Supports both IPv4 and IPv6 addresses.

set vpp interfaces ipip <ipipN> source-address <address>

Set the tunnel source address. Must match an address configured on the local system.

Basic Example:

set vpp interfaces ipip ipip1
set vpp interfaces ipip ipip1 remote 203.0.113.2
set vpp interfaces ipip ipip1 source-address 192.168.1.1

Interface Configuration

Description and Administrative Control

set vpp interfaces ipip <ipipN> description <description>

Set a descriptive name for the IPIP interface.

set vpp interfaces ipip <ipipN> disable

Administratively disable the IPIP interface.

Kernel Interface Integration

set vpp interfaces ipip <ipipN> kernel-interface <interface-name>

Bind a kernel interface to the IPIP tunnel for management and application compatibility.

For detailed information about kernel interface integration, see VPP Kernel Interfaces Configuration.

Configuration Examples

IPv4 IPIP Tunnel

# Basic IPv4 IPIP tunnel
set vpp interfaces ipip ipip1
set vpp interfaces ipip ipip1 description "Site-to-site IPIP tunnel"
set vpp interfaces ipip ipip1 remote 203.0.113.10
set vpp interfaces ipip ipip1 source-address 192.168.1.1

IPv6 IPIP Tunnel

# IPv6 endpoints
set vpp interfaces ipip ipip2
set vpp interfaces ipip ipip2 remote 2001:db8::2
set vpp interfaces ipip ipip2 source-address 2001:db8::1

IPIP with Kernel Interface

# IPIP tunnel with management interface
set vpp interfaces ipip ipip3
set vpp interfaces ipip ipip3 remote 203.0.113.30
set vpp interfaces ipip ipip3 source-address 192.168.1.1
set vpp interfaces ipip ipip3 kernel-interface vpptun3
set vpp kernel-interfaces vpptun3 address 10.0.2.1/30