5G Core Deployment Using Kubermatic KubeOne

Community KubeOne
July 7, 2020

In this blog post, we shall be looking at how to use the KubeOne project to deploy a 5G core PoC. 5G is the next iteration of mobile technology with an emphasis on using cloud native technologies of which Kubernetes is meant to play an important role. KubeOne is a production grade open source Kubernetes cluster life cycle management tool. AWS will be used for the cloud provider in this blog post.

The 5G core solution that will be used is free5gc (version 3.0.1) which is an open source software. Free5gc has some requirements in order to achieve a successful deployment, these are:

The sdnvortex controller is deployed as a daemonset but uses an init-container to create the second network interface.

Note: There are several ways to achieve multiple interfaces in a Kubernetes pod, the sdnvortex controller was selected for this write-up since it is fairly easy to set up.

Below is the diagram (from the free5gc repo) for the 5Gc deployment:

5Gc Deployment Diagram

The only difference between this diagram and the PoC is that instead of using the localhost addresses, a static IP is used with the second network card inside each pod. IP details for the second network are given below:










Details about installing KubeOne on AWS can be found here. A snapshot of the cluster status is given below:

Kubernetes Cluster Status

After installing a KubeOne cluster with the specific AMI (5.0.0-23-generic kernel image and Open vSwitch), the Kubernetes manifests for the 5G components can be retrieved from here.

Note: The N3IWF was not used in this post.

After applying the manifests, the status of the pods can be seen below:

Status of the Pods

Let’s see the IP details for one of the pods.

Pod IP Details

We can see that a second interface, eth1 with an IP address of has been allocated by the sdnvortex controller to the AMF pod.

As of now, open source 5G SA emulators are not available to simulate the connectivity of a gNB/UE to the 5G core deployment. However, we can check the logs of the SMF pod to see that it was able to initiate a PFCP connection with the UPF:

PFCP connection

Sample logs from the NRF pod show communication between it and the remaining 5G core components over the service based interface:

Sample Logs from the NRF pod

From the logs above, we can see that the SBI communication is over HTTP using REST (i.e. the GET and PUT statements).


In this blog post, we deployed a 5G core to a Kubernetes cluster running using KubeOne on AWS and checked its connectivity. In a future post, we will show how to install and run a 5G core on vSphere.

Where to learn more

Christopher Adigun

Christopher Adigun

Software Engineer