summaryrefslogtreecommitdiff
path: root/docs/_rst_legacy/vpp/configuration/interfaces/rst-ipip.rst
blob: 4ad21c4153fbe6b173ed706c4b77492301f25c9c (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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
:lastproofread: 2026-03-13

.. _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 interfaces vpp ipip <vppipipN>

   Create an IPIP interface where ``<vppipipN>`` follows the naming
   convention ``vppipip1``, ``vppipip2``, etc.

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

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

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

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

**Basic Example:**

.. code-block:: none

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

Interface Configuration
-----------------------

Description and Administrative Control
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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

   Set a descriptive name for the IPIP interface.

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

   Administratively disable the IPIP interface.

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

Kernel interface is bound to the VPP IPIP interface for management and
application compatibility.

IP Address Configuration
------------------------

.. cfgcmd:: set interfaces vpp ipip <vppipipN> address <ip-address/prefix>

   Configure IPv4 or IPv6 addresses on the kernel interface. Multiple
   addresses can be assigned.

**Examples:**

.. code-block:: none

   # IPv4 address
   set interfaces vpp ipip vppipip0 address 192.168.1.10/24

   # IPv6 address
   set interfaces vpp ipip vppipip0 address 2001:db8::10/64

MTU Configuration
-----------------

.. cfgcmd:: set interfaces vpp ipip <vppipipN> mtu <size>

   Set the Maximum Transmission Unit (MTU) for the kernel interface.
   The MTU must be compatible with the connected VPP interface.

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

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

.. code-block:: none

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

IPv6 IPIP Tunnel
^^^^^^^^^^^^^^^^

.. code-block:: none

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

IPIP with Kernel Interface
^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: none

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