OSMO-BSC(1)

📦
version 1.13.0 · 6 versions
, in ubuntu resolute, ubuntu stonking

💖 osmo-bsc — Osmocom BSC 💖

okay bestie, sit down, we're doing osmo-bsc(1) and honestly? it's giving telecom royalty. 👑

✨ NAME ✨

osmo-bsc — the Osmocom BSC (that's a Base Station Controller, in case the acronym was gatekeeping you). 🎀

🌸 SYNOPSIS 🌸

osmo-bsc [options]

🦋 DESCRIPTION 🦋

So. This is the BSC-only version of OpenBSC. That means it is not a whole network by itself — it needs a Mobile Switching Center (MSC) to actually do its thing. Like, it will not function without one. fr fr. 😭

And if that's not the vibe you're going for, you might rather prefer osmocom-nitb, which is considered a "GSM Network-in-a-Box" and — key detail — does not depend on an MSC. main character energy, no supporting cast required. 💅

Typically you start osmo-bsc with the -c option, specifying where to find the configuration file. And there are example configuration files chilling right here if you need inspo:

/usr/share/doc/osmo-bsc/examples/osmo-bsc

copy one, tweak it, slay. ✨

👑 OPTIONS 👑

  • -h, --help — prints this text. the classic "help me" button, always there for you. 🫶
  • -D, --daemonize — forks the process into a background daemon. it goes and lives its own life in the background, periodt. 🌙
  • -d option, --debug=DRLL:DCC:DMM:DRR:DRSL:DNM — enable debugging. you pass in the debug categories colon-separated like that, exactly as written. 🔍
  • -s, --disable-color — turns the colors off. (sad, I know, but sometimes you need plain output.) 🎨🚫
  • -T, --timestamp — print a timestamp in the debug output. so you know when everything went down. ⏰
  • -c, --config-file <filename> — the config file to use. this is the one you'll reach for constantly, bestie. 📄
  • -l, --local=IP — the local address of the MGCP. 📍
  • -e, --log-level <number> — set a global loglevel. one number, controls the whole loudness situation. 🔊
  • -r, --rf-ctl <NAME> — a unix domain socket to listen for cmds. yes, a socket, listening for commands. 🔌
  • -t, --testmode — a special mode to provoke failures at the MSC. not me being dramatic but this is literally its purpose — it deliberately causes trouble over at the MSC. use it knowing that. 💀

🔥 SEE ALSO 🔥

💜 AUTHOR 💜

This manual page was written by Ruben Undheim <ruben.undheim@gmail.com> for the Debian project (and may be used by others). 🫡 thank you for your service, icon.

okay and finally, the receipts: this one's from the OSMO-BSC(1) manual, dated 26 January 2026. that's it, that's the page, go configure something cute. 💅✨🦋

📦 where this page comes from