# garywill/linux-router

Set Linux as router in one command. Support Internet sharing, redsocks, Wifi hotspot, IPv6. Can also be used for routing VM/containers 🛰️

Repository: https://github.com/garywill/linux-router
Canonical: https://ross.abutalabs.com/products/linux-router
Language: Shell
License: LGPL-2.1
License Family: copyleft
Topics: linux, router, gateway, wifi-hotspot, transparent-proxy, redsocks, create-ap, nat, nated-wifi-access-point, internet-sharing, access-point, ipv6, ipv6-subnetting
Last push: 2026-07-08T13:15:44+00:00

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 91, release rhythm 60, longevity 100
- inputs: {"age_days": 2924, "days_push": 56, "days_rel": 56, "gap_med": 320.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2047, forks 182 (observed 2026-08-28T04:06:08.930093+00:00)

## What it is
A single-file bash script that turns a Linux machine into a router in one command, wrapping iptables, dnsmasq, and related tools. It supports NATed sub-networks, WiFi hotspots, DHCP/DNS serving, IPv6, transparent proxying via redsocks, and routing for VMs and containers.

## Use cases
- share my internet connection from linux over wifi hotspot
- create a NATed wifi access point from the command line
- route network traffic for VMs and containers through my linux host
- set up a transparent proxy with redsocks on linux
- run a DHCP and DNS server for a small LAN
- share ethernet internet to another PC or switch
- enable IPv6 on a NATed local network

## When to choose
- you want a one-command, easily reversible router/hotspot setup on Linux
- you need to share Internet to WiFi clients, wired clients, or VMs/containers
- you want transparent proxying or DNS hijacking without complex manual iptables/dnsmasq configuration
- you need multiple isolated routed sub-network instances on one machine

## When to avoid
- you need a full enterprise router or firewall appliance with a web UI
- you are on a non-Linux platform
- your WiFi hardware/driver does not support AP mode
- you prefer packaged software from your distro's repositories

## Facets
- artifact type: cli-tool
- maturity: active
- function: networking, proxy, security, cli, configuration-management
- domain: networking, operating-systems, self-hosted, privacy
- platform: cli
- tags: wifi-hotspot, nat, internet-sharing, dnsmasq, iptables, transparent-proxy, redsocks, ipv6, access-point, vm-networking, shell-script, command-line, linux

## Member repositories
- garywill/linux-router (main) score 82

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:08.930093+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:57:58.178084+00:00, confidence not recorded.
  - readme: https://github.com/garywill/linux-router (fetched 2026-08-28T04:06:08.930093+00:00, sha 31935fd90621)
- Data as of 2026-08-30T08:39:29.467469+00:00.