Quick Start Guide - RFS-Portable-BTS

📋 Prerequisites Checklist

🔄 Installation Workflow

Automated installation process with progress monitoring and error recovery

✅ Required Hardware

Raspberry Pi 4 with 8GB RAM
BladeRF Mini A4 SDR device
GeeekPi DeskPi Lite Case with M.2 support
2TB M.2 SSD or 64GB+ MicroSD card
5V/3A USB-C power supply
GSM-compatible SIM cards (2-3 for testing)

✅ System Requirements

Ubuntu 22.04 LTS (recommended)
Internet connection for installation
SSH access or direct console access

💻 Automated Installation (Recommended)

Clone Repository

                            git clone https://github.com/TelcoSec/RFS-Portable-BTS.git
cd RFS-Portable-BTS
                        

Run Installation Script

                            # Make scripts executable
chmod +x install/install.sh install/verify.sh

# Start automated installation
./install/install.sh
                        

What the installer does:

Updates system packages
Installs all dependencies
Downloads and installs YateBTS
Configures BladeRF Mini A4
Sets up web interface
Creates system services
Optimizes system performance

Installation time: 15-30 minutes

Verify Installation

                            # Run verification script
./install/verify.sh
                        

This will check:

✅ System requirements
✅ YateBTS installation
✅ BladeRF Mini A4 detection
✅ Service status
✅ Network configuration

⚙️ Basic Configuration

Configure YateBTS

                            # Edit main configuration
sudo nano /etc/yate/ybts.conf

# Basic settings to configure:
[GSM]
arfcn=975
mcc=001
mnc=01
lac=1
cell_id=1
cell_name=MyYateBTS
tx_power=20
                        

Add SIM Cards

                            # Add SIM card information
sudo nano /etc/yate/sims.conf

[sim1]
imsi=001010123456789
msisdn=1234567890
ki=your-ki-key-here
opc=your-opc-key-here
                        

🚀 Start and Test Your BTS

Start Services

                            # Start YateBTS service
sudo systemctl start yatebts
sudo systemctl enable yatebts

# Start web interface
sudo systemctl start apache2
sudo systemctl enable apache2
                        

Test Your BTS

                            # Check service status
sudo systemctl status yatebts

# Check web interface
curl http://localhost/yatebts

# Monitor logs
sudo journalctl -u yatebts -f
                        

🎉 Success!

Your YateBTS is now running! Connect test phones and search for your network "MyYateBTS".

📚 Next Steps

Explore More

Complete YateBTS Installation Tutorial - Detailed step-by-step guide
Complete YateBTS API Reference - Programmatic control and automation
YateBTS Troubleshooting Guide - Common issues and solutions
YateBTS Security Best Practices - Hardening and protection
Raspberry Pi 4 8GB Hardware Specifications - Complete hardware guide