This guide is based on Fedora 33 Distribution.

Note: Fedora 33 is not working

Getting MongoDB

Install MongoDB with package manager.

$ sudo dnf -y install mongodb-server

Run MongoDB server.

$ mkdir -p ./data/db
$ mongod --dbpath ./data/db

Setting up TUN device (No persistent after rebooting)

Create the TUN device. Interface name will be ogstun.

$ sudo dnf -y install iproute
$ sudo ip tuntap add name ogstun mode tun
$ ip link show

Then, to support IPv6-enabled UEs, you must configure your TUN device to support IPv6.

$ sysctl -n net.ipv6.conf.ogstun.disable_ipv6

$ sudo -w sysctl net.ipv6.conf.ogstun.disable_ipv6=0

$ sysctl -n net.ipv6.conf.ogstun.disable_ipv6

Note: If your TUN device already supports IPv6, you can skip this steps above.

You are now ready to set the IP address on TUN device.

$ sudo ip addr add dev ogstun
$ sudo ip addr add 2001:db8:cafe::1/48 dev ogstun

Make sure it is set up properly.

$ sudo ip link set ogstun up
$ ip link show

Tip: The script provided in $GIT_REPO/misc/netconf.sh makes it easy to configure the TUN device as follows: $ sudo ./misc/netconf.sh

Building Open5GS

Install the depedencies for building the source code.

$ sudo dnf install python3 ninja-build gcc gcc-c++ flex bison git lksctp-tools-devel libidn-devel gnutls-devel libgcrypt-devel openssl-devel cyrus-sasl-devel libyaml-devel mongo-c-driver-devel libmicrohttpd-devel libcurl-devel libnghttp2-devel libtalloc-devel iproute

Install Meson

$ sudo dnf install meson

Git clone.

$ git clone https://github.com/open5gs/open5gs

To compile with meson:

$ cd open5gs
$ meson build --prefix=`pwd`/install
$ ninja -C build

Check whether the compilation is correct.

$ ./build/tests/attach/attach ## EPC Only
$ ./build/tests/registration/registration ## 5G Core Only

Run all test programs as below.

$ cd build
$ meson test -v

Tip: You can also check the result of ninja -C build test with a tool that captures packets. If you are running wireshark, select the loopback interface and set FILTER to s1ap || gtpv2 || pfcp || diameter || gtp || ngap || http2.data.data || http2.headers. You can see the virtually created packets. testattach.pcapng/testregistration.pcapng

You need to perform the installation process.

$ cd build
$ ninja install
$ cd ../

Building WebUI of Open5GS

Node.js is required to build WebUI of Open5GS

$ sudo dnf -y install nodejs

Install the dependencies to run WebUI

$ cd webui
$ npm ci --no-optional

The WebUI runs as an npm script.

$ npm run dev