# SurfControl User Guide

# SurfControl User Guide

SurfControl is the management console for your 5G2GO private cellular network. It lets you see what's happening on your network, add new devices, and fix common issues—all from a web browser.

 ![SurfControl Dashboard](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/bcdc8248-9752-47b6-aef9-c30b5d469051/728868d9-d6d5-4064-9973-a9a8787d625f/dashboard.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260927%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260927T134500Z&X-Amz-Expires=86400&X-Amz-Signature=a4c17bbb1f58a9c559fc8c81ad1b9a6f2d465fff96ff26d7287722e154a51faf&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) *The SurfControl dashboard showing network status at a glance*


---

## Accessing SurfControl

Open your web browser and go to your SurfControl URL:

```
http://[your-system-ip]:8080
```

The exact address depends on your installation. Ask your administrator if you're unsure.

Once connected, you'll see the **Dashboard** with your network's current status.


---

## Understanding the Dashboard

The dashboard gives you a quick overview of your entire network.

### Status Cards

At the top, four cards show key numbers:

| Card | What It Means |
|------|---------------|
| **Provisioned Subscribers** | Total devices set up on your network |
| **Registered UEs** | Devices that have connected at least once |
| **Connected Devices** | Devices actively using the network right now |
| **Connected gNodeBs** | Radio units (cell towers) currently online |

### System Health

Below the cards, you'll see:

* **Core Status** — Shows "Operational" (green) when your network is running normally
* **Active Connections** — Shows "Active" when devices are connected, "None" when idle

### Connected gNodeBs

This section lists your radio units. Each entry shows:

* The radio's name and ID
* Its IP address
* Connection status (green "Connected" badge when online)

### Active Connections

A table showing every device currently using your network:

* **Device Name** — The friendly name you assigned
* **IMSI** — The device's unique network ID (like a phone number)
* **IP Address** — The address assigned to the device on your network
* **DNN** — The network service the device is using
* **Status** — Shows "CONNECTED" when actively communicating


---

## Managing Devices

The **Subscribers** page is where you manage all devices on your network.

 ![Subscribers List](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/bcdc8248-9752-47b6-aef9-c30b5d469051/a0e0c4ac-2722-47cd-b286-66025e037e63/subscribers-list.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260927%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260927T134500Z&X-Amz-Expires=86400&X-Amz-Signature=db4738446f8ffd54f2366caa5dd20bd54b9b6ef2067bdb044e579d5b3848b67a&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) *The subscriber list showing all provisioned devices*

### Viewing Your Devices

Click **Subscribers** in the left menu to see all devices. The table shows:

| Column | Description |
|--------|-------------|
| **Device Name** | The name you gave this device |
| **IMSI** | The device's unique ID (15-digit number) |
| **Static IP** | The IP address assigned to this device |
| **Service** | Shows "ENABLED" when the device can connect |
| **Actions** | View, edit, or remove the device |

### Finding a Device

Use the search box to filter by:

* Device name (e.g., "Camera-01")
* IMSI number
* IP address

### Adding a New Device


1. Click the green **Add Subscriber** button
2. Fill in the form:

 ![Add Subscriber](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/bcdc8248-9752-47b6-aef9-c30b5d469051/1dd4e728-5f3c-42f0-adde-054eae8f84f7/add-subscriber-modal.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260927%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260927T134500Z&X-Amz-Expires=86400&X-Amz-Signature=dbc74a706596754a95127984f7a9daf94a3f5ba72ca7d03c681f6379d52e4d8b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) *Adding a new device to the network*

| Field | What to Enter |
|-------|---------------|
| **Device Name** | A friendly name (e.g., "Main-Camera", "Encoder-1") |
| **Device Number** | A unique number (1-999) — this determines the device's ID and IP address |


3. Click **Add Subscriber**

The system automatically creates:

* A unique device ID based on your network settings
* A static IP address for the device

**After adding:** Insert the SIM card with matching unique ID (IMSI), power on, and add APN ‘internet’ if data connection is not immediately established. Updates from SurfControl are live almost immediately.

### Editing a Device


1. Find the device in the list
2. Click the **pencil icon** in the Actions column
3. Update the device name
4. Click **Save**

### Removing a Device


1. Find the device in the list
2. Click the **trash icon** in the Actions column
3. Confirm the removal

**Note:** Removing a device disconnects it immediately. The device won't be able to use the network until re-added.


---

## Network Configuration

The **Network Config** page shows your network's settings. This is view-only—contact your administrator to make changes.

 ![Network Configuration](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/bcdc8248-9752-47b6-aef9-c30b5d469051/d67e3e90-93e0-4353-9631-c17c2af1557f/network-config.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260927%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260927T134500Z&X-Amz-Expires=86400&X-Amz-Signature=360ef591bafa39db4ebbbb82edcba4e879f5f5f89b3a0bed19d042489f00f177&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) *Network configuration showing current settings*

Key settings you'll see:

| Setting | What It Means |
|---------|---------------|
| **PLMN ID** | Your network's unique identifier |
| **DNNs** | Available network services (data connections) |
| **IP Pool** | The range of addresses assigned to devices |
| **Bandwidth** | Upload/download speed limits |


---

This system is configured with three DNN, think of them like a high level group with it’s own rules and configuration that apply to all users. In 90% of cases your devices will use the ‘internet’ DNN. This system is used in our labs for testing so we have some additional DNNs shown.

## Radio Management (gNodeB)

The **gNodeB Management** page helps you manage your radio units and fix connectivity issues. The current version of SurfControl supports the following radios;

| Make - Model - Technology | 5G2GO Support | Supported in SurfControl |
|---------------------------|---------------|--------------------------|
| BTI Indoor/Outdoor 5G     | Yes           | Yes                      |
| Moso Networks Indoor/Outdoor 5G | Yes           | Dec 2025                 |
| Baicells Indoor/Outdoor 5G | Yes           | Q1 2026                  |


 ![gNodeB Management](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/bcdc8248-9752-47b6-aef9-c30b5d469051/0ef350e4-8826-499d-9cf3-80b1618b588f/gnodeb-management.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260927%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260927T134500Z&X-Amz-Expires=86400&X-Amz-Signature=9e824b5bcc7c2fb90efd206facf87ab514d9fda3b9738fd6d1166abeae96eacd&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) *Managing radio units and their connection to the spectrum system*

### What You'll See

For each radio unit:

**SAS Registration** (connection to the spectrum system):

* **Status** — "Granted" (green) means the radio is authorized to transmit
* **Last Heartbeat** — When the radio last checked in
* **SSL Errors** — "No" is good; "Yes" indicates a time sync problem
* **Healthy** — Overall status indicator


---

### **BTI Indoor 5G Radio Only**

#### **Time Synchronization**

* **System Time** — The radio's current clock
* **Time Drift** — How far off the radio's clock is (should be under 60 seconds)

### Fixing Common Issues

#### Radio Shows "Not Registered" or Has SSL Errors

This usually means the radio's clock is wrong. The spectrum authorization system rejects radios with incorrect time.

**Quick fix — use the automated button:**


1. Click **Automate SAS Registration**
2. Confirm when prompted
3. Wait about 70 seconds for the process to complete

This automatically:

* Syncs the radio's clock
* Restarts the registration service
* Verifies the connection

**Manual fix:**


1. Click **Sync Time** to correct the clock
2. Click **Restart CBRS** to reconnect to the spectrum system
3. Wait 60 seconds, then click **Refresh** to check status

#### Time Drift Over 60 Seconds

Large time drift causes SSL certificate errors. Click **Sync Time** to correct it.

#### Status Stuck on "In Progress"

The radio is trying to register. Wait 2-3 minutes. If it doesn't change to "Granted," try the automated fix above.


---

## Troubleshooting

### Device Won't Connect


1. **Check the device is provisioned** — Look for it on the Subscribers page
2. **Verify SIM credentials** — Make sure the device's SIM # matches the IMSI shown
3. **Check radio status** — Go to gNodeB Management and ensure status is "Granted"
4. **Check signal** — The device needs to be in range of your radio unit

### Dashboard Shows No Active Connections

This is normal when no devices are actively transmitting. Devices may show as "Registered" but not "Connected" when idle (screen off).

### Radio Shows Offline


1. Check physical connections to the radio unit
2. Verify the radio has power
3. Check network cables between the radio and your system

### Can't Access SurfControl


1. Verify you're on the same network as the system
2. Check the URL is correct
3. Try refreshing the page
4. Contact your administrator if the problem persists


---

## Quick Reference

| Task | Where to Go |
|------|-------------|
| See network status | Dashboard   |
| Add a new device | Subscribers → Add Subscriber |
| Find a device | Subscribers → Search box |
| Check radio health | gNodeB Management |
| Fix radio registration | gNodeB Management → Automate SAS Registration |
| View network settings | Network Config |


---

## Getting Help

If you encounter issues not covered here:


1. Note any error messages you see
2. Check which page you're on and what you were trying to do
3. Reach out to the team [support@waveriders.live](mailto:support@waveriders.live)


---

*SurfControl v1.3.2 — Making private cellular networks accessible to everyone.*