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(), and systemd-tmpfiles-setup-dev-early is 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 .deb depends on docker.io and the two conflict. Either use a base image without Docker preinstalled or apt-get remove docker-ce docker-ce-cli containerd.io first (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 because MemTotal excludes firmware reservation a genuine 8 GB
    machine reported 7 GB and was refused. If you previously had to run with
    QT_SKIP_PREFLIGHT=1 on an 8 GB box, you no longer do.