Installation Instructions

Prerequisites

OS: Ubuntu 24.04 LTS or 22.04 LTS

CPU: Intel i5 or i7

---

1. Install PPAs of dependencies:

sudo add-apt-repository ppa:pistache+team/unstable
sudo add-apt-repository ppa:nuandllc/bladerf
sudo apt-get update
sudo apt-get install bladerf bladerf-fpga-hostedxa4 smcroute ca-certificates curl

---

2. Add the Bitstem package repository

Download the signing key:

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://packages.bitstem.com/5gm.pubkey.gpg -o /etc/apt/keyrings/bitstem.asc
sudo chmod a+r /etc/apt/keyrings/bitstem.asc

Add the package repo as a source for APT:

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/bitstem.asc] https://packages.bitstem.com/ \
  $(. /etc/os-release && echo "$VERSION_CODENAME") main" | \
  sudo tee /etc/apt/sources.list.d/bitstem.list > /dev/null

---

3. Install 5GM

sudo apt update
sudo apt install 5gm

This version installs a systemd unit for 5GM. You can control the service through

sudo systemctl start/stop/restart/... 5gm

If you want to run the process manually, stop the service first:

systemctl stop 5gm
/opt/5gm/bin/5gm

---

4. Updating 5GM

Future updates can be installed by running:

sudo apt update
sudo apt install 5gm