Skip to content

Deploy free5GC helm in Minutes: The Ultimate One-Script Setup Guide

Welcome to the free5GC helm quick setup guide! If you are using the free5gc-helm to deploy your k8s environment. Here is a new method which is more convenient to setup a new helm in new machine.

Note

This ansible script is used for quick setup at an empty machine. If you have already setup previously, please refer to free5gc-helm for customized operation.

Prerequisites

  • CPU: AMD or Intel CPU.
  • OS: Ubuntu 20.04, 22.04, 24.04, or 25.04.
  • Tools: The git command must be installed on your system.

In this quick setup scrip, we will use ansible to run the whole installation. As a result, it can be deploy on both remote machine and local machine.

Install ansible:

sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository --yes --update ppa:ansible/ansible
sudo apt install -y ansible

Get the Ansible book

The ansible files is placed under our free5GC repo.

git clone https://github.com/free5gc/free5gc

Setup Your Destination Machine

In the file, free5gc/ansible-helm/inventory.ini, you have to specify the destination machine you want to setup the free5gc-helm.

[k8s]
<host IP> work_node=<host name>

Run the Script

cd free5gc
./quick-setup-helm.sh

ansible will use ssh to do the install operation in the target machine so you will be asked about the user and user password.

Ansible will help you to install:

  • microk8s
  • kubectl
  • helm
  • k9s
  • enable required addons in microk8s
  • gtp5g

  • free5gc-helm

    • core network chart
    • ue/ran simulator chart

Result

Ansible will show if there is failed task:

ansibleResult

After installed, use k9s -A to check all pods are running:

k9s