summaryrefslogtreecommitdiff
path: root/docs/vpp/configuration/interfaces/ipip.rst
blob: 92ceba914e78729d6d10326ce3246b742aa0a1f5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
:lastproofread: 2025-09-04

.. _vpp_config_interfaces_ipip:

.. include:: /_include/need_improvement.txt

######################
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
^^^^^^^^^^^^^^^^^^^^^^^^^^

.. cfgcmd:: set vpp interfaces ipip <ipipN>

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

.. cfgcmd:: set vpp interfaces ipip <ipipN> remote <address>

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

.. cfgcmd:: set vpp interfaces ipip <ipipN> source-address <address>

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

**Basic Example:**

.. code-block:: none

   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
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. cfgcmd:: set vpp interfaces ipip <ipipN> description <description>

   Set a descriptive name for the IPIP interface.

.. cfgcmd:: set vpp interfaces ipip <ipipN> disable

   Administratively disable the IPIP interface.

Kernel Interface Integration
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. cfgcmd:: 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 :doc:`kernel`.

Configuration Examples
----------------------

IPv4 IPIP Tunnel
^^^^^^^^^^^^^^^^

.. code-block:: none

   # 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
^^^^^^^^^^^^^^^^

.. code-block:: none

   # 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
^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: none

   # 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