Container & Kubernetes Deployment Guide

Official GHCR Container Catalog

Deployment Walkthrough

1. 1
   Interactive Container Execution:

   Run any containerized suite with host network and USB hardware passthrough:

   Terminal — Run SDR or 5G Core Container

   # Run Core Network auditing container interactively
   docker run --rm -it --net=host --privileged \
     ghcr.io/telcosec-tools/telcochisel-core-network:latest
   
   # Run SDR container with USB device access
   docker run --rm -it --net=host --privileged -v /dev/bus/usb:/dev/bus/usb \
     ghcr.io/telcosec-tools/telcochisel-sdr:latest

   Copy
2. 2
   Deploy Rootless Podman Telecom Pods:

   Launch multi-container pods sharing a unified localhost network namespace without root privileges:

   Terminal — Podman Play Kube

   # Launch Telecom Pod (Core Network + Diagnostic Scanner)
   podman play kube docker/pods/podman-telecom-pod.yaml
   
   # Open shell in the diagnostic scanner container
   podman exec -it telcochisel-telecom-pod-telecom-scanner /bin/bash
   
   # Teardown pod when finished
   podman play kube --down docker/pods/podman-telecom-pod.yaml

   Copy
3. 3
   Kubernetes Cluster Orchestration:

   Deploy production 5G Core Network pods into a Kubernetes cluster using the bundled deployment script:

   Terminal — Kubernetes Deployment

   # Deploy 5G Core Pod into cluster
   bash docker/pods/pod-deploy.sh apply-k8s docker/pods/k8s-5g-core-pod.yaml
   
   # Verify pod status and logs
   kubectl get pods -l app=telcochisel-5g-core
   kubectl logs -f telcochisel-5g-core-pod -c open5gs-core

   Copy
4. 4
   Unified Deployment & Build Manager:

   Use the all-in-one terminal wizard to launch containers, manage pods, or trigger builds:

   Terminal — Interactive Deployment Menu

   ./deploy_menu.sh

   Copy

TelcoSec Academy Integration

Pre-built container images can be orchestrated directly inside the TelcoSec Academy Interactive Labs for hands-on cellular exploitation training, O-RAN auditing exercises, and red team challenge scenarios.