A complete 5G Standalone network on Kubernetes
5G core (Open5GS or free5GC) · real OCUDU gNB (O-RAN split 7.2) · UERANSIM · web dashboard for operation and measurement
InnovaNetwork builds and runs a lab 5G SA network entirely on Kubernetes (k3s): the core, the real radio gNB, the simulated gNB/UE and the dashboard run as pods of a single cluster, configured from text files and installed by idempotent scripts.
It was built and validated at the Innova Center with commercial phones, a LiteOn FlexFi O-RU (n78, 4T4R) and an Intel E810 card, but it is designed to be replicable: everything that depends on the hardware is isolated and documented.
- Everything on Kubernetes. Core, OCUDU gNB, UERANSIM and dashboard in the same k3s cluster, with two machines: one for the core and one (a dedicated node) for the radio.
- Two cores, one at a time. Open5GS (default) and free5GC (optional) installed side by side; switching is one click in the dashboard.
- Real radio. OCUDU gNB (CU+DU, split 7.2, DPDK) as a pod, with the same performance as the native service (~92 % of the fronthaul packets on time).
- Operation dashboard. Innova Center Dashboard: per-UE radio metrics, core, RU, machines, logs, control (start/stop/switch core), configuration editing, persistent history and comparable experiments. English or Portuguese.
- Configuration in text, nothing hard-coded. PLMN, slices, IPs, versions and the radio setup come from
config.env,free5gc/free5gc.envandran/ocudu/ocudu.env. - Safe after a reboot. After a boot nothing on the radio starts by itself (the GPS can take minutes): the operator starts it from the dashboard once the sync is ready.
CORE machine (k3s server) RAN machine (k3s node)
┌────────────────────────────────────────────────┐ ┌──────────────────────────────────┐
│ ns open5gs ns free5gc (optional) │ │ ns ocudu │
│ Open5GS AMF ─┐ free5GC AMF ─┐ │ │ pod ocudu-gnb (OCUDU CU+DU) │
internet ◄─┤ (N6/NAT) UPF ─┤ UPF ─┤ │ │ host network, DPDK, PTP │
│ UERANSIM │ UERANSIM │ │ │ │
│ dashboard │ │ │ │ E810 ── fronthaul 7.2 ──┐ │
│ :30998 macvlan "ran-link" (N2/N3)│ │ └──────────┬───────────────┼───────┘
└────────────────────┬───────────────┴───────────┘ │ │
└────────── fiber N2/N3 + cluster ───────────┘ ┌──────┴──────┐
10.10.0.0/24 │ O-RU (n78) │ ))) phones
└─────────────┘
Details, IPs, ports and folders: docs/architecture.md.
| Component | Version | Where it runs | Documentation |
|---|---|---|---|
| Open5GS (default core) | 2.7.5 | namespace open5gs |
components/open5gs.md |
| free5GC (optional core) | v4.3.0 | namespace free5gc |
components/free5gc.md |
| UERANSIM (simulated gNB/UE) | 3.2.6 | one pair per core | components/ueransim.md |
| OCUDU (real gNB) | commit pinned by the user | namespace ocudu, RAN node |
components/ocudu.md |
| Innova Center Dashboard | 3.0 | namespace open5gs, port 30998 |
components/dashboard.md |
| k3s + Multus | v1.36.5+k3s1 | both machines | architecture.md |
Core only, with a simulated UE (one Ubuntu 24.04 machine, no radio), in ~15 minutes:
git clone https://github.com/Miguelclunardi/InnovaNetwork.git
cd InnovaNetwork
sudo ./install.sh # k3s, Open5GS, UERANSIM and dashboard (idempotent)
./test.sh # registration, PDU session and ping through the core: "7 checks OK"Open the dashboard at http://<machine IP>:30998.
Complete network with a real radio: follow the installation.
| 🧭 Documentation overview | where to start, depending on your goal |
| 🏗️ Architecture | machines, components, networks, IPs, ports and folders |
| ⚙️ Installation | from scratch to a phone browsing the internet |
| 🕹️ Operation | day to day: start, switch core, reboot, tests |
| 🎓 Tutorials | step by step: first test, phone on the network, core switch, OCUDU on k8s, experiments… |
| 🧩 Components | Open5GS · free5GC · UERANSIM · OCUDU · Dashboard |
| 🔧 Reference hardware | Intel E810 + LiteOn FlexFi: PTP/GNSS, DPDK, XDP, n78 cell |
| 🩺 Troubleshooting | symptom → cause → fix |
| 🛠️ Development | code map and how to extend it |
The same documentation is shown in the dashboard, in the Documentation tab.
InnovaNetwork/
├── install.sh · uninstall.sh · test.sh # Open5GS core + UERANSIM + dashboard (core machine)
├── config.env # main configuration
├── free5gc/ # optional free5GC core (own installer)
├── ran/ocudu/ # OCUDU gNB on Kubernetes (own installer, depends on the setup)
├── dashboard/ # dashboard (app/), core-machine agents (agent/), translations (i18n/)
├── scripts/ # installer library, boot recovery, subscribers
├── helm/ # Multus and chart post-renderers
└── docs/ # documentation
| Core machine | RAN machine (optional) | |
|---|---|---|
| OS | Ubuntu 24.04 LTS | Ubuntu 24.04 LTS, low-latency kernel |
| CPU / RAM | 4+ vCPU with AVX · 8 GiB | isolated CPUs for the gNB · 1 GiB hugepages |
| Network | internet; dedicated port for the N2/N3 fiber | NIC with SR-IOV/DPDK and PTP (e.g. Intel E810) + GNSS |
| Radio | — | O-RAN 7.2 O-RU (e.g. LiteOn FlexFi) |
| Version | Content |
|---|---|
| v3.0 | OCUDU on Kubernetes (dedicated node), dashboard controlling the gNB through Kubernetes, new documentation |
| v2.x | two cores (Open5GS + free5GC), switched from the dashboard |
| v1.x | Open5GS core on k3s with UERANSIM; dashboard |
Full history: CHANGELOG.md.
Contributions are welcome: new hardware profiles, fixes and documentation. See CONTRIBUTING.md.
Apache License 2.0. The projects used (Open5GS, free5GC, UERANSIM, OCUDU, k3s, Gradiant charts, uPlot) keep their own licenses.
Responsible use: use a test PLMN (
001-01) and follow the spectrum regulations of your region when transmitting with a real radio.