{"id":14563557,"url":"https://github.com/spr-networks/super","last_synced_at":"2026-05-04T07:04:41.287Z","repository":{"id":37603532,"uuid":"402212200","full_name":"spr-networks/super","owner":"spr-networks","description":"📡 SPR: Open Source, secure, user friendly and fast wifi routers for your home. One wifi password per device. Ad Blocking \u0026 Privacy Blocklists. Policy Based Network Access","archived":false,"fork":false,"pushed_at":"2024-05-22T20:40:12.000Z","size":29819,"stargazers_count":97,"open_issues_count":25,"forks_count":9,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-05-22T20:46:59.617Z","etag":null,"topics":["adblock","alerting","coredns","golang","homelab","nftables","router","security","security-tools","self-hosted","vpn","wifi","wifi-security","wireguard"],"latest_commit_sha":null,"homepage":"https://www.supernetworks.org/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spr-networks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-01T21:50:47.000Z","updated_at":"2024-08-16T07:20:13.929Z","dependencies_parsed_at":"2023-11-10T07:15:44.893Z","dependency_job_id":"e062a338-4ff3-4450-aabf-889d33c6a63d","html_url":"https://github.com/spr-networks/super","commit_stats":null,"previous_names":[],"tags_count":235,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spr-networks%2Fsuper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spr-networks%2Fsuper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spr-networks%2Fsuper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spr-networks%2Fsuper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spr-networks","download_url":"https://codeload.github.com/spr-networks/super/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":217902389,"owners_count":16248434,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adblock","alerting","coredns","golang","homelab","nftables","router","security","security-tools","self-hosted","vpn","wifi","wifi-security","wireguard"],"created_at":"2024-09-07T02:02:48.641Z","updated_at":"2025-12-25T08:25:05.736Z","avatar_url":"https://github.com/spr-networks.png","language":"JavaScript","funding_links":[],"categories":["wifi"],"sub_categories":[],"readme":"# 📡 SPR: Open Source, secure, user friendly and fast wifi routers for your home. \n\n[![release version](https://img.shields.io/github/v/release/spr-networks/super)](https://github.com/spr-networks/super/releases/latest)\n![version](https://img.shields.io/github/v/tag/spr-networks/super?sort=semver\u0026label=version)\n![docker build](https://github.com/spr-networks/super/actions/workflows/docker-image.yml/badge.svg?branch=main)\n![iso build](https://github.com/spr-networks/super/actions/workflows/pi-ubuntu-iso.yml/badge.svg?branch=main)\n![license](https://img.shields.io/github/license/spr-networks/super)\n\n## Overview\n\nCreate an adaptive, micro-segmented network for managing WiFi devices, remote VPN access, and wired systems.\n\n* One Password Per WiFi Device\n* Policy Based / Zero Trust Network Access\n* Per-Device DNS Rules \u0026 Ad Block Lists\n\n\u003cimg width=\"1218\" alt=\"image\" src=\"https://github.com/spr-networks/super/assets/37549748/c0ebf4fe-0a29-4087-a039-53968c87a00b\"\u003e\n\n## Get Involved \n\n💬 Have questions? Join the conversation in our [Discussions](https://github.com/spr-networks/super/discussions) page.\n* [Join the Discord chat](https://discord.gg/EUjTKJPPAX)\n* [Stay in the loop](https://sendfox.com/supernetworks) with our newsletter\n\n## How it Works\n\nAn unspoofable device identity is established with a MAC address and Per-Device Passphrase for WiFi (or a VPN Public Key for Remote Devices). From there, each device gets its own /30 subnet to exist on. Hardening and strict firewall rules block network spoofing and impersonation, and routing rules redefine connectivity between devices and to the internet.\n\n## Features\n\nSecurity\n- Multi-PSK including with WPA3, a SPR first\n- Secure Router Chaining\n- Almost no unmanaged code, minimized attack surfaces\n\nFirewall:\n- One-way connectivity to service resources\n- Device Groups \u0026 Isolation\n- Port Forwarding\n- Custom Interface rules for integrations \n- Scheduling, Event-Based Triggers *\n- DNAT Rewriting * \n  \nWiFi \n- WPA3/2\n- WPA1 backwards compatibility\n- WiFi 6 Support\n\nAdvanced Networking\n- Wireguard™ VPN\n- Multi WAN with Load Balancing\n- Wireless Uplink\n- Multicast Traffic Support\n- Mesh with Wired Backhaul *\n- Policy Based Site Forwarding  *\n\nAdvanced DNS Capabilities\n- Remote DNS Queries with DNS over HTTPs \n- DNS Ad Block lists\n- Per-Device DNS Rules and Overrides\n\nUser Friendly\n- React UX\n- iOS App Available * \n\nObservability\n- IP Traffic\n- DNS Logs\n- Event System \u0026 DB\n- API  \n\nInteroperability:\n- Runs on a wide variety of Linux systems with Docker\n- API Plugin System \n\n\u0026ast; Some features are part of SPR PLUS, a paid subscription to support the project\n\n## Our Goals\n1. Be the best Security \u0026 Privacy choice\n2. Programmable with an API \n3. Easy to use \n\n## Frequently Asked Questions\nCheck out our [FAQ](https://www.supernetworks.org/pages/docs/faq) on our website\n\n## Why SPR Over Alternatives\n\nSPR is built to support an adapative, microsegmented network that unifies WiFi, DNS, Routing, and Policy. It's not easy to bolt on the concepts onto exising router stacks while also achieving high assurance security that blocks network spoofing attacks and other network flaws. \n\n## UI Demo Page\n\nhttps://demo.supernetworks.org/\n\n## SPR Bus Events\n\nhttps://github.com/spr-networks/sprbus\n\n![image](https://user-images.githubusercontent.com/37542945/232639810-7e17380c-42ea-480b-811e-cf5add04a0d2.gif)\n\n## Updating \n#### Building from scratch\n```bash\n./build_docker_compose.sh --load\ndocker-compose up -d\n```\n\nFor performance and to minimize wear on SD cards, the build uses a memory-backed filesystem. On memory-limited devices, this can cause build failures if memory is exhausted. In this case, you can provide the build argument `--set \"*.args.USE_TMPFS=false\"`.\n\n\n#### Using prebuilt containers\n```bash\ndocker-compose pull\n./setup.sh # (optional)\ndocker-compose up -d\n```\n\n## Useful Links\n\n* [supernetworks.org](https://www.supernetworks.org/)\n* [API Docs](https://www.supernetworks.org/pages/api/0)\n* [Documentation Home](https://www.supernetworks.org/pages/docs/intro)\n* [Raspberry Pi 4 Setup Guide](https://www.supernetworks.org/pages/docs/setup_guides/pi4b)\n* [General Setup Guide](https://www.supernetworks.org/pages/docs/setup_guides/setup_run_spr)\n* [Virtual Setup Guide (Personal VPN)](https://www.supernetworks.org/pages/docs/setup_guides/virtual_spr)\n\n* [FAQ](https://www.supernetworks.org/pages/docs/faq)\n* [Get the iOS App](https://apps.apple.com/us/app/secure-programmable-router/id6443709201)\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspr-networks%2Fsuper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspr-networks%2Fsuper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspr-networks%2Fsuper/lists"}