SPR
Generated on 2 Dec 2024 from the SPR catalog page
SPR (Secure Programmable Router) lets users run a hardened, secure, open source VPN.
Run a self-hosted VPN, DNS & other services to filter & redirect traffic, block ads, and more.
Block Ads, filter DNS and keep track of your devices - all with a documented API allowing programmatic control of your network.
The droplet will update to the latest stable version of SPR when creating the instance.
Software Included
Package | Version | License |
---|---|---|
super | latest | BSD-3 Clause |
Docker CE | 20.10.25 | Apache 2 |
Docker Compose | 1.29.2 | Apache 2 |
Creating an App using the Control Panel
Click the Deploy to DigitalOcean button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.
Creating an App using the API
In addition to creating a Droplet from the SPR 1-Click App using the control panel, you can also use the DigitalOcean API. As an example, to create a 4GB SPR Droplet in the SFO2 region, you can use the following curl
command. You need to either save your API access token) to an environment variable or substitute it in the command below.
curl -X POST -H 'Content-Type: application/json' \
-H 'Authorization: Bearer '$TOKEN'' -d \
'{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image": "supernetworks-spr"}' \
"https://api.digitalocean.com/v2/droplets"
Getting Started After Deploying SPR
Deployment steps
- Deploy a Droplet from the Marketplace
- Log on using SSH
ssh root@your_droplet_public_ipv4
admin credentials & instructions to add a vpn peer will be presented
Add a VPN peer
cd /home/spr/super; ./virtual_install.sh
Connect to VPN
- Import config or scan QR code in Wireguard & enable the VPN connection
- Connect to http://192.168.2.1
- Login with the admin credentials
- Done!
Read more in the Virtual SPR Guide
Access HTTP interface over ssh:
ssh root@your_droplet_public_ipv4 -N -L 8000:127.0.0.1:8000
Connect to http://localhost:8000