Banana BPI-R3 Setup Guide
Turn your Banana Pi BPI-R3 into a WiFi Router, Secure VPN, or both with SPR. This guide will show you how.
Install a Docker Host System
SPR can run on any host which supports Docker, however, it is best tested with Ubuntu
You can install Ubuntu 22.04 images form https://wiki.banana-pi.org/Banana_Pi_BPI-R3#Ubuntu
Preparing your own build
git clone -b gdrive-test https://github.com/frank-w/BPI-Router-Images
./buildimg.sh bpi-r3 noble
gunzip -c bpi-r3_sdmmc.img.gz | sudo dd bs=1M status=progress conv=notrunc,fsync of=/dev/sdX
First Boot
login
user: root password: bananapi
ssh root-login enabled (should be disabled after other users are created)
/etc/ssh/sshd_config (open e.g. with nano): add # before PermitRootLogin=yes and restart ssh daemon
systemctl restart ssh
VPN Only (Virtual SPR)
SPR can run as a VPN server only. See the full VPN Setup Guide.
When running in Virtual SPR mode it uses a virtual network, so the host system's firewall and network configuration is unaffected.
Quick VPN Setup
sudo bash -c "$(curl -fsSL https://raw.github.com/spr-networks/super/master/virtual_install.sh)"
VPN Port Forwarding
If there is a firewall port 51280/udp needs to be open for incoming traffic, and port forwarded to the device
WiFi Access Point / WiFi Router
When setting up SPR as a router it will configure the host device's network. SPR is distributed as source and as prebuilt docker images. You can get them started
Follow the full setup guide
Getting started quickly:
git clone https://github.com/spr-networks/super
cd super
sudo ./base/scripts/setup.sh
reboot
cd ~/super/
docker compose up -d
Need Help?
Contact us with any questions
The BPI R3 Hardware
| Category | Specification |
|---|---|
| CPU | MediaTek MT7986(Filogic 830) Quad core ARM Cortex A53+MT7531 chip design |
| SDRAM | 2 GB DDR4 |
| On board Storage | MicroSD (TF) card, 8GB eMMC onboard |
| GPIO | 26 Pin GPIO, some of which can be used for specific functions including UART, I2C, SPI, PWM, I2S |
| On board Network | 5 Port 10/100/1000Mbps Ethernet |
| SFP | 2 SFP 2.5GbE |
| Wifi | Wifi 6 4x4 2.4G Wifi(MT7975N) +4x4 5G Wifi(MT7975P) |
| mini PCIE | Mini PCIe via USB |
| M.2 interface | M.2 KEY-M PCIe interface |
| USB | 1 USB 3.0 host, 2 USB interface with slot |
| Buttons | Reset button, WPS button, boot switch |
| Leds | Power status Led and RJ45 Led |
| DC Power | 12V/2A with DC in |
| Sizes | 100.5x148mm same as Banana Pi BPI-R64 and Banana Pi BPI-R2 |
| Weight | 200g |