1. Prerequisites
| Item | Minimum | Recommended |
|---|---|---|
| OS | Ubuntu 24.04 LTS | Ubuntu 24.04 LTS |
| Kernel | 6.x | 6.14+ |
| CPU | 4 cores | 10+ cores (1 for main, 6 for VPP workers, 3 for OS/services) |
| RAM | 8 GB | 16 GB |
| Disk | 20 GB free | 40 GB free |
| NIC (management) | 1× 1 Gbps, kernel driver | same |
| NIC (subscriber-facing) | 1× DPDK-supported (Intel E810/E830, XL710) | same |
| Network | LAN access to the customer subnet + upstream router | same |
About the kernel. Ubuntu 24.04.4 ships 6.8, which is the kernel this release is validated on, so a stock install is fine. Preflight warns below 6.14 because a few DPDK plugins fall back there; it does not refuse. If that fallback matters for your NIC, linux-generic-hwe-24.04 provides 6.14. It is not required.
CPU pinning matters. If the box has isolated cores for VPP (isolcpus=1-6 in /proc/cmdline — the recommended setup), the installer preserves whatever corelist-workers line matches those cores. If the box has no isolcpus, the installer falls back to a single-worker boot-safe config.
Don't run this on a shared / production box. The installer edits /etc/vpp/startup.conf, opens ports 8443/3000, installs docker.io if missing, and adds systemd units. Fine for a dedicated appliance; disruptive on a general-purpose server.
If you're evaluating in VirtualBox, three constraints:
- First-boot hang (fixed). Evaluation images before 1.3.0-13 could hang
intermittently on first boot. It was traced to an expedited RCU grace period
that never completes under VirtualBox — one vCPU never reports quiescent to
synchronize_rcu_expedited(), andsystemd-tmpfiles-setup-dev-earlyis the
first visible victim rather than the cause. The image now boots with
rcupdate.rcu_normal=1, measured at 75 consecutive clean boots on 3 and
4 vCPU. The evaluation appliance ships with 3 vCPU; there is no need to
reduce it. (Earlier guidance called this an SMP deadlock and advised ≤ 2
vCPUs — both the diagnosis and the advice were wrong.) - docker-ce in the host image will block install — the controller
.debdepends ondocker.ioand the two conflict. Either use a base image without Docker preinstalled orapt-get remove docker-ce docker-ce-cli containerd.iofirst (preflight will detect this and abort with an actionable message). - VirtualBox guests don't expose
pdpe1gb— the installer detects that and falls back
to 2 MiB pages, reaching the same total in more of them. No action needed from you. - Hugepages are sized to the box (new in 1.3.0). The installer reserves 8 GiB on a
machine with 12 GiB or more, and 2 GiB below that. Previously it reserved a flat 8 GiB
regardless — which on an 8 GiB machine is the entire box, leaving nothing for the OS,
VPP's control plane or the controller. - The 8 GB minimum now actually works (new in 1.3.0). Preflight used to floor-divide
the memory it read, and becauseMemTotalexcludes firmware reservation a genuine 8 GB
machine reported 7 GB and was refused. If you previously had to run with
QT_SKIP_PREFLIGHT=1on an 8 GB box, you no longer do.