Configuration Guide

May 15, 2026 ยท View on GitHub

PFCP Agent

This document focuses on frequently used configurations.

Please refer to upf.jsonc file for the full list of configurable parameters.

Common configurations

These are configurations commonly shared between P4-UPF and BESS-UPF.

ConfigDefault valueMandatoryComments
log_levelinfoNo
hostname-NoUsed to get local IP address and local NodeID in PFCP messages
http_port8080No
max_req_retries5NoMax retries for sending PFCP message towards SMF/SPGW-C
resp_timeout2sNoPeriod to wait for a response from SMF/SPGW-C
enable_end_markerfalseNo
enable_gtpu_path_monitoringfalseNo
cpiface.enable_ue_ip_allocfalseNoWhether to enable UPF-based UE IP allocation
cpiface.ue_ip_pool-Yes for P4-UPF or when enable_ue_ip_alloc is setIP pool from which we allocate UE IP address
cpiface.dnn-NoData Network Name to use during PFCP Association

BESS-UPF specific configurations

ConfigDefault valueMandatoryComments
measure_upffalseNoEnable per port metrics
measure_flowfalseNoEnable per flow metrics
access.ifname-YesAccess-facing network interface name
core.ifname-YesCore-facing network interface name
enable_notify_bessfalseNoWhether to enable Notify feature for DDNs