Download | 1xBTS

Common setup

$ git clone https://github.com/chrismoos/1xbts.git
$ cd 1xbts

# build dependencies
$ sudo apt-get install -y build-essential pkg-config protobuf-compiler \
    libssl-dev libclang-dev libre-dev

# support services (Postgres, fou-nat, dashboard)
$ sudo modprobe fou ipip
$ docker compose up -d --build

$ git clone https://github.com/chrismoos/1xbts.git
$ cd 1xbts

# build dependencies (Homebrew)
$ brew install protobuf llvm pkg-config

# support services (bridge networking + host.docker.internal)
$ docker compose -f docker-compose.yml -f docker-compose.macos.yml up -d --build

Dashboard at localhost:3000 · Postgres :45432.

Run with your radio

$ sudo apt-get install -y libbladerf-dev
$ cargo run --release -p cdma-nib --no-default-features --features bladerf-backend -- \
    --config-dir config --radio-config config/radio_bladerf_micro2.json

$ sudo apt-get install -y libuhd-dev
$ cargo run --release -p cdma-nib --no-default-features --features uhd-backend -- \
    --config-dir config --radio-config config/radio_uhd_b210_native.json

$ sudo apt-get install -y liblimesuite-dev
$ cargo run --release -p cdma-nib --no-default-features --features lime-backend -- \
    --config-dir config --radio-config config/radio_limesdr_mini2_native.json

Pick the backend for your SDR — see Hardware. EV-DO is enabled in bts.json; the radio profile stays hardware-specific.

✓config/radio_uhd_b210_native.json — USRP B200/B210 backend profile

✓config/radio_bladerf_micro2.json — bladeRF Micro 2.0 backend profile

✓Set bts.evdo.enabled and explicit bts.evdo.channel for composite or EV-DO-only operation

✓Sample rate and RF bandwidth are derived at startup from the configured carrier mode

Next, walk through bring-up in getting started, read the EV-DO guide, or browse the source on GitHub.