Welcome to Gluon

Gluon is a modular framework for creating OpenWrt-based firmware images for wireless mesh nodes. Several Freifunk communities in Germany use Gluon as the foundation of their Freifunk firmware.

User Documentation

• Getting Started
  • Selecting the right version
  • Dependencies
  • Building the images
  • opkg repositories
  • Make variables
• Site configuration
  • Configuration
  • Build configuration
  • Config mode texts
  • Site modules
  • Examples
• Supported Devices & Architectures
  • armsr-armv7
  • armsr-armv8
  • ath79-generic
  • ath79-mikrotik
  • ath79-nand
  • brcm2708-bcm2708
  • brcm2708-bcm2709
  • ipq40xx-generic
  • ipq40xx-mikrotik
  • ipq806x-generic
  • lantiq-xrx200
  • lantiq-xway
  • mediatek-filogic
  • mediatek-mt7622
  • mpc85xx-p1010
  • mpc85xx-p1020
  • ramips-mt7620
  • ramips-mt7621
  • ramips-mt76x8
  • realtek-rtl838x
  • rockchip-armv8
  • sunxi-cortexa7
  • x86-generic
  • x86-geode
  • x86-64
  • Footnotes
• x86 support
  • Targets
• Frequently Asked Questions
  • What hardware is supported?
  • Why does DNS not work on the nodes?
• MTU for Mesh-VPN
  • What is a good MTU on the mesh-vpn?

Features

• Config Mode
  • Activating Config Mode
  • Port Configuration
  • Accessing Config Mode
• Autoupdater
  • Building Images
  • Manifest format
  • Automated nightly builds
  • Infrastructure
  • Command Line
• WLAN configuration
  • Upgrade behaviour
• Private WLAN
• Wired mesh (Mesh-on-WAN/LAN)
  • Wired mesh encapsulation
  • Configuration
• DNS caching
• Node monitoring
  • Format of collected data
  • Accessing Node Information
  • Adding a data provider
• Multidomain Support
  • Preamble
  • Overview
  • Switching the domain
  • Allowed site variables
  • Example config
• Adding SSH public keys
• Roles
• Mesh VPN
  • Protocol handlers
  • fastd
  • WireGuard

Developer Documentation

• Development Basics
  • Bug Tracker
  • IRC
  • Working with repositories
  • Development Guidelines
• Adding hardware support
  • Hardware requirements
  • Device checklist
  • Device classes
  • Target configuration
  • Hardware support in packages
• Package development
  • Development workflow
  • Gluon package makefiles
  • Feature flags
• Upgrade scripts
  • Basics
  • Best practices
  • Script ordering
• Uplink support
  • Routing tables
  • libpacketmark
  • gluon-wan-dnsmasq
• MAC addresses
• gluon.site library
• Build system
  • Feed management
  • Helper scripts
• Debugging
  • Kernel Oops

gluon-web Reference

• Controllers
• Models
• Views
• Internationalization support
• Config Mode

Packages

• gluon-client-bridge
• gluon-config-mode-domain-select
• gluon-ebtables-filter-multicast
• gluon-ebtables-filter-ra-dhcp
• gluon-ebtables-limit-arp
• gluon-ebtables-source-filter
• gluon-hoodselector
• gluon-logging
• gluon-mesh-batman-adv
• gluon-mesh-wireless-sae
• gluon-radv-filterd
• gluon-scheduled-domain-switch
• gluon-web-admin
• gluon-web-logging

Releases

• Release Notes

License

See LICENCE

Indices and tables

• Search Page