How meshlinkfoundation/meshlink-wifi-gateway works
meshlink WiFi Gateway provisions a Raspberry Pi as a guest WiFi hotspot with captive-portal access control. The main guest workflow is: join the access point, receive DHCP configuration, get redirected to the broker portal, select access, and have forwarding enabled for the session. Operators configure the gateway with the installer and manage it through the broker dashboard. The repository tree contains only installer/bootstrap scripts and one guest-interface helper; the broker and host networking services are external runtime components. Relationships below are based on the README, not inspected source excerpts.
Main entry points: install.sh Gateway installer · bootstrap.sh Bootstrap · meshlink-guest-up.sh Guest interface setup
Components 15
Gateway provisioning
- Bootstrap
bootstrap.sh - Gateway installer
install.sh
Guest access
- WiFi access point
- Guest bridge
- Guest interface setup
scripts/meshlink-guest-up.sh - DHCP and DNS
- Firewall and NAT
- Meshlink broker
- Captive portal
- Authorized IP sessions
Operator services
- Operator dashboard
- Stripe payments
- Tailscale VPN
Other components
- Gateway operator
- Guest device
Connections 23
- Gateway operator → Bootstrap: starts setup
README.md - Bootstrap → Gateway installer: runs
README.md - Gateway operator → Gateway installer: configures gateway
README.md - Gateway installer → WiFi access point: configures access point
README.md - Gateway installer → DHCP and DNS: configures DHCP/DNS
README.md - Gateway installer → Firewall and NAT: configures forwarding
README.md - Gateway installer → Meshlink broker: installs and configures
README.md - Gateway installer → Guest interface setup: installs helper
README.md - WiFi access point → Guest bridge: bridges AP
README.md - Guest interface setup → Guest bridge: brings up interfaces
README.md - Guest device → WiFi access point: joins WiFi
README.md - Guest device → DHCP and DNS: gets IP configuration
README.md - Guest device → Firewall and NAT: sends HTTP check
README.md - Firewall and NAT → Meshlink broker: redirects port 80
README.md - Meshlink broker → Captive portal: serves portal
README.md - Guest device → Captive portal: selects access tier
README.md - Meshlink broker → Authorized IP sessions: authorizes client IP
README.md - Firewall and NAT → Guest device: allows session forwarding
README.md - Gateway operator → Operator dashboard: manages gateway
README.md - Operator dashboard → Meshlink broker: served by
README.md - Meshlink broker → Stripe payments: starts paid checkout
README.md - Gateway operator → Tailscale VPN: sets up remote access
README.md - Tailscale VPN → Operator dashboard: provides remote reachability
README.md