View on GitHub Star

Gradiant 5G Charts

A curated collection of 5G/6G related Helm Charts

Open5gs and OAI-GNB

5G end to end (SA) communication demo using hardware equipment with Open5gs and OpenAirInterface gNB.

This setup uses 2 helm charts generated by Gradiant: open5gs and oai-gnb. These charts are packaged and available at Gradiant’s DockerHub repo:

If you want to have the repo in local you can pull it:

helm pull oci:// --version 2.2.0
helm pull oci:// --version 0.3.1

Equipment requirements

The following hardware equipment is required in order to replicate the setup used for this tutorial:

It is recommended to keep the UE with the airplane mode turned on until the NGC and RAN have been successfully deployed and connected.

Additional Requirement: ettus-device-plugin Daemonset

You need another prerequisite in your Kubernetes cluster in order to complete this deployment successfully. You will have to deploy an ettus-device-plugin Daemonset that is meant to manage the USRPs as Kubernetes Node Resources and automatically mount them in the corresponding Pods.

Go to, where you will find additional information and where the corresponding Kubernetes manifest is located (ettus-daemonset.yaml). Then, execute the following command in order to create the corresponding Kubernetes resource:

kubectl apply -f

After this is completed, you can rely on Kubernetes to place the device plugin’s Pod onto Nodes, to restart the daemon Pod after failure, and to help automate upgrades.

Deployment NGC and registration of subscriber

First, deploy the NGC (open5gs) using the 5gSA-values.yaml file provided in order to overwrite some of the default values of the Open5GS chart:

helm install open5gs oci:// --version 2.0.8 --values 

These new values will:

The successful registration can be verified following 2 different approaches:

kubectl exec deployment/open5gs-mongodb -ti -- bash


use open5gs


Deployment RAN

Before installing the corresponding helm chart, make sure of having properly connected your USRP to one of your cluster’s nodes.

Now, deploy the RAN (oai-gnb) using the gnb-values.yaml file provided in order to overwrite some of the default values of the oai-gnb chart:

helm install oai-gnb oci:// --version 0.3.1 --values 

Thus, this deployment will launch the eNodeB and connect it to the Open5GS NGC.

It is important to notice that the default values in th gnb section for mcc, mnc, mncLength, tac, sst and sd0 match those configured in the open5gs chart and the registered UE.

In addition, take into account that the value given for gnb.amf must match the name of the corresponding AMF service deployed by the open5gs chart. Therefore, in case you use a differente release name for the open5gs chart, make sure that this value is set accordingly.

The value for image.tag provided is set to 2022.w20, since it was the version of the gradiant/oai image tested in this tutorial.

Verify EPC and RAN connectivity

Connection between SMF and UPF (C-Plane and U-Plane of NGC)

Check that the SMF gets associated with the UPF’s address:

kubectl logs deployment/open5gs-smf -f

Connection between AMF and gNodeB

Check that the AMF accepts and adds the gNodeB:

kubectl logs deployment/open5gs-amf -f

AMF finds gNodeB

Check that gNodeB is deployed successfully and that is waiting for UE’s detection:

kubectl logs oai-gnb-0 -f

gNodeB waiting for UE

Connect UE to the network

Once the NGC and RAN are deployed and successfully connected as shown above, the UE will be able to connect to the network. Make sure that it has de sysmocom USIM with the registered credentials correctly inserted.

Also, check the APN configuration in the UE. It has to be enabled the following APN:

At this point, you can turn off the airplane mode in the UE so it starts attempting to connect to the network.

Verify UE’s connectivity

Check that the UE got successfully attached to the network:

kubectl logs deployment/open5gs-amf -f

UE attached to network

We installed and used the PingTools application in the UE in order to test the UE’s connectivity. Open this application and, through the ping section of the app, you can easily test the UE’s connectivity to the gNodeB and to the Internet:

UE's connectivity

Check that the gNodeB is seeing data from the UE:

UE's connectivity to gNB

It’s even possible to check that the UEs’ traffic is being routed correctly through their PDU sessions, capturing the packets in the UPF. The installation of tcpdump in the corresponding pod is needed in order to complete this check:

kubectl exec deployment/open5gs-upf -ti -- bash

apt update && apt install tcpdump

tcpdump -i ogstun

Capturing traffic in the UPF (Wireshark)


Clean the deployment for this demo by uninstalling the 2 helm charts previously installed:

helm uninstall oai-gnb

helm uninstall open5gs