Skip to content

Install

Choose one of the installation methods below.

Install the required dependencies:

sudo snap install go --channel=1.27/stable --classic
sudo snap install node --channel=24/stable --classic
sudo apt update
sudo apt -y install gcc

Clone the Ella MOCN repository:

git clone https://github.com/ellanetworks/mocn.git
cd mocn

Build the frontend:

npm install --prefix ui
npm run build --prefix ui

Build Ella MOCN:

go build -o mocn -ldflags "-s -w -X github.com/ellanetworks/mocn/version.GitCommit=$(git rev-parse HEAD)" ./cmd/mocn

Configure Ella MOCN:

vim mocn.yaml

Start Ella MOCN:

./mocn --config mocn.yaml

Create a new directory:

mkdir ella-mocn
cd ella-mocn

Copy the following file into this directory:

docker-compose.yaml
configs:
  ella_mocn_config:
    content: |
      logging:
        level: info
      db:
        path: /data/mocn.db
      api:
        address: 0.0.0.0
        port: 5030
      ran:
        signalling:
          address: 0.0.0.0
          s1_port: 36412
          ng_port: 38412

services:
  ella-mocn:
    image: ghcr.io/ellanetworks/ella-mocn:latest
    configs:
      - source: ella_mocn_config
        target: /mocn.yaml
    entrypoint: /bin/mocn --config /mocn.yaml
    restart: unless-stopped
    network_mode: host
    volumes:
      - ella-mocn-data:/data

volumes:
  ella-mocn-data:

Start the Ella MOCN container:

docker compose up -d

Ensure your Kubernetes cluster nodes meet the system requirements.

Download the Ella MOCN manifests:

git clone --depth 1 https://github.com/ellanetworks/mocn.git

Deploy Ella MOCN:

kubectl create namespace ella
kubectl apply -k mocn/k8s

Open the UI and API on your machine:

kubectl port-forward -n ella svc/ella-mocn 5030:5030

S1 is at ella-mocn-s1.ella.svc.cluster.local:36412 and NG at ella-mocn-ng.ella.svc.cluster.local:38412.

Ella MOCN's UI and API are at http://<host-ip>:5030. Open the UI and create the first user.

See the configuration reference for all options.