Call for Contributions
Help improve this section with additional content, examples, and explanations.
For contribution guidelines, see Write Documentation.
VPP Dataplane Requirements
VPP Dataplane requires specific hardware. Ensure your system meets these prerequisites before enabling VPP:
Deployment Platform
VPP Dataplane is available on both bare-metal, on-premise virtualized, and cloud deployment platforms.
CPU Requirements
Regardless of the platform, VPP Dataplane requires a CPU with:
SSE4.2 support (available on most modern Intel and AMD CPUs).
At least 4 physical CPU cores for a minimum configuration (more cores recommended for higher throughput).
Important
Physical Cores vs Logical Cores
VPP Dataplane requires 4 physical CPU cores, not logical cores. Systems with Simultaneous Multithreading (SMT) or Hyper-Threading (HT) present each physical core as 2 logical cores.
Cloud providers often display logical cores as “cores” or “vCPUs”. For example, a cloud instance showing “4 cores” may have only 2 physical cores with SMT/HT enabled. Always verify the actual physical core count in your cloud provider’s documentation.
For virtualized environments, ensure CPU features are passed through to the VM and that sufficient physical cores are allocated.
Memory Requirements
Memory significantly affects VPP stability. Insufficient RAM can cause initialization failures or prevent the dataplane from starting.
Minimum: 8 GB RAM. VyOS will not start the VPP Dataplane if less than 8 GB is available.
Recommended: 16 GB or more (especially for high throughput, many interfaces, or large routing tables).
Network Interface Cards (NICs)
Warning
VyOS supports only specific NICs for the VPP dataplane. Using unsupported hardware may cause activation failures, initialization errors, crashes, or degraded performance.
When enabling VPP, VyOS checks detected network interfaces against a list of validated NICs. Validation is based on the PCI ID of the device or the kernel driver used by the interface.
Supported NICs:
Filter Type
Filter Value
NIC Name/Description
Platform Where NIC Can Be Found
PCI ID
15b3:1019
Mellanox Technologies MT28800 Family [ConnectX-5 Ex]
Bare-metal
PCI ID
15b3:101d
Mellanox Technologies MT2892 Family [ConnectX-6 Dx]
Bare-metal
PCI ID
15b3:101e
Mellanox Technologies ConnectX Family mlx5Gen Virtual Function
Oracle Cloud
PCI ID
8086:1592
Intel Corporation Ethernet Controller E810-C for QSFP
Bare-metal
PCI ID
1ae0:0042
Google, Inc. Compute Engine Virtual Ethernet [gVNIC]
Google Cloud
PCI ID
1af4:1000
Red Hat, Inc. Virtio network device
KVM-based hypervisors, including with Open vSwitch; Google Cloud
PCI ID
1d0f:ec20
Amazon.com, Inc. Elastic Network Adapter (ENA)
AWS
Kernel Driver
hv_netvsc
Microsoft Hyper-V network interface card
Microsoft Azure
If no supported NIC is detected, VPP activation will be rejected.
In testing or advanced deployments, unsupported hardware can be explicitly allowed in the configuration:
Note
This option bypass the hardware validation checks for the specified devices. Stability and performance are not guaranteed when using unsupported NICs or drivers.