Repolode
Submit
Jaksay

Jaksay/Linux-Router

A Flask-based web console that turns a Debian or Armbian device into a router, managing wired networking, Wi-Fi, hotspots and connected clients.

View on GitHubWebsite
Stars
171
Forks
7
Open issues
0
Last commit
3 months ago

What is it?

Linux Router turns a Debian 13 or Debian-based Armbian device into a router that is configured through a web console. It covers system status, wired and Wi-Fi network management, hotspot creation, hotspot client visibility with DHCP leases and wireless signal details, and maintenance tasks such as dependency repair, password changes and reboots.

The system is split into two systemd services. The Flask web service runs as an unprivileged user, while a separate root Agent executes allowlisted system queries and network changes over a Unix socket. Network operations are run serially by the Agent, and the web interface polls the result to refresh status.

Installation, upgrade and uninstall are handled by a shell script that pulls the source archive from GitHub. Because these operations modify NetworkManager, netplan and dhcpcd configuration, they can interrupt connectivity and are best run from a local console or during a maintenance window.

Key features

  • 01System overview covering hardware, IP addresses, storage, memory and runtime status
  • 02Wired and Wi-Fi management with scanning, connecting and profile binding
  • 03Hotspot creation in exclusive AP mode or supported AP+STA concurrent mode
  • 04Hotspot client list with DHCP leases and wireless signal details
  • 05Keepalive that recovers the hotspot after unexpected disconnection
  • 06Dependency checks and guided repair for NetworkManager, dnsmasq and iptables

Use cases

  • Turning a spare Debian or Armbian single-board computer into a Wi-Fi hotspot gateway
  • Managing a small home or lab network from a browser instead of the command line
  • Sharing a wired or Wi-Fi uplink with connected devices through a local hotspot

Topics

#router#networking#flask#networkmanager#hotspot#wifi#debian#raspberry-pi

FAQ

What is Linux-Router?
A Flask-based web console that turns a Debian or Armbian device into a router, managing wired networking, Wi-Fi, hotspots and connected clients. Linux Router turns a Debian 13 or Debian-based Armbian device into a router that is configured through a web console. It covers system status, wired and Wi-Fi network management, hotspot creation, hotspot client visibility with DHCP leases and wireless signal details, and maintenance tasks such as dependency repair, password changes and reboots.
Is Linux-Router free to use? What license does it have?
Linux-Router is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is Linux-Router still maintained?
Updated within 6 months. The last commit to Linux-Router was on Jul 28, 2026.
What can I use Linux-Router for?
Turning a spare Debian or Armbian single-board computer into a Wi-Fi hotspot gateway Managing a small home or lab network from a browser instead of the command line Sharing a wired or Wi-Fi uplink with connected devices through a local hotspot
Where can I get Linux-Router?
The source code and installation instructions are on GitHub: https://github.com/Jaksay/Linux-Router

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects