OpenAirInterface 5G Core Network Deployment

August 11, 2026 ยท View on GitHub

Openairinterface logo

[[TOC]]

OpenAirInterface 5G Core Network Deployment

This page is the starting point for OAI 5G Core deployment tutorials. If this is your first time with the project, follow the quick-start path below before moving to feature-specific guides.

Supported Hosts

The official OAI CN5G container images use Ubuntu 22.04 as the container base image. They are compatible with the following Linux hosts:

Host familySupported versions
Ubuntu22.04 through 26.04
Fedora39 through 43
RHEL8 through 10

Any Docker or Podman version available for those host releases should be fine. The tutorials use Docker command names in most examples; when using Podman, replace docker with podman and use your distribution's Compose-compatible command where needed.

First Deployment

  1. Prepare the host with the deployment pre-requisites.
  2. Run the basic Docker Compose deployment with Duranta/OAI RAN and UE.

Choose A Tutorial

GoalStart here
Learn the Docker Compose deployment, static UE IP allocation, and OAI RF simulator testBasic deployment
Run a compact end-to-end core plus RAN testMini deployment with gnbsim
Test with UERANSIMDeployment with UERANSIM
Test with OMEC GnbsimDeployment with OMEC gnbsim
Use the eBPF UPFDeployment with UPF eBPF
Use the legacy VPP UPFDeployment with UPF-VPP
Use MongoDB instead of MySQLMongoDB deployment
Configure QoS policiesQoS tutorial
Configure Ethernet PDU sessionsEthernet PDU sessions
Configure slicingNetwork slicing tutorial
Configure traffic redirectionTraffic redirection tutorial
Configure traffic steeringTraffic steering tutorial
Configure UL CLUL CL tutorial
Deploy with Helm chartsOpenAirInterface orchestration repository

Reference Guides

Developer Guides

Support