Welcome to Gluon

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

User Documentation

• Getting Started
  • Selecting the right version
  • Dependencies
  • Building the images
  • opkg repositories
  • Make variables
• Site configuration
  • Configuration
  • Packages
  • Config mode texts
  • Site modules
  • Examples
• x86 support
  • Targets
• Frequently Asked Questions
  • DNS does not work on the nodes

Features

• Config Mode
  • Activating Config Mode
  • Port Configuration
  • Accessing Config Mode
• Autoupdater
  • Building Images
  • Automated nightly builds
  • Infrastructure
  • Command Line
• WLAN configuration
  • Upgrade behaviour
• Private WLAN
• Wired mesh (Mesh-on-WAN/LAN)
  • Configuration
• DNS forwarder
• Node monitoring
  • Format of collected data
  • Accessing Node Information
  • Adding a data provider
• Adding SSH public keys
• Roles

Developer Documentation

• Development Basics
  • Bug Tracker
  • IRC
  • Working with repositories
  • Development Guidelines
• Adding support for new hardware
  • Hardware requirements
  • Adding profiles
  • Adding support for new hardware targets
• Upgrade scripts
  • Basics
  • Best practices
  • Script ordering
• WAN support
  • Routing tables
  • libpacketmark
  • gluon-wan-dnsmasq
• MAC addresses

gluon-web Reference

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

Packages

• gluon-client-bridge
• gluon-config-mode-geo-location
• gluon-ebtables-filter-multicast
• gluon-ebtables-filter-ra-dhcp
• gluon-ebtables-segment-mld
• gluon-ebtables-source-filter

Releases

• Gluon 2017.1.8
• Gluon 2017.1.7
• Gluon 2017.1.6
• Gluon 2017.1.5
• Gluon 2017.1.4
• Gluon 2017.1.3
• Gluon 2017.1.2
• Gluon 2017.1.1
• Gluon 2017.1
• Gluon 2016.2.7
• Gluon 2016.2.6
• Gluon 2016.2.5
• Gluon 2016.2.4
• Gluon 2016.2.3
• Gluon 2016.2.2
• Gluon 2016.2.1
• Gluon 2016.2
• Gluon 2016.1.6
• Gluon 2016.1.5
• Gluon 2016.1.4
• Gluon 2016.1.3
• Gluon 2016.1.2
• Gluon 2016.1.1
• Gluon 2016.1
• Gluon 2015.1.2
• Gluon 2015.1.1
• Gluon 2015.1
• Gluon 2014.4
• Gluon 2014.3.1
• Gluon 2014.3

Supported Devices & Architectures

ar71xx-generic

• 8devices
  • Carambola 2
• ALFA Network
  • AP121
  • AP121U
  • Hornet-UB
  • Tube2H
  • N2
  • N5
• Allnet
  • ALL0315N
• Buffalo
  • WZR-HP-AG300H / WZR-600DHP
  • WZR-HP-G300NH
  • WZR-HP-G300NH2
  • WZR-HP-G450H
• D-Link
  • DIR-505 (A1, A2)
  • DIR-615 (C1)
  • DIR-825 (B1)
• GL Innovations
  • GL-AR150
  • GL-AR300M
  • GL-AR750 [1]
  • GL-iNet 6408A (v1)
  • GL-iNet 6416A (v1)
• Linksys
  • WRT160NL
• Netgear
  • WNDR3700 (v1, v2)
  • WNDR3800
  • WNDRMAC (v2)
• Onion
  • Omega
• OpenMesh
  • MR600 (v1, v2)
  • MR900 (v1, v2)
  • MR1750 (v1, v2) [1]
  • OM2P (v1, v2)
  • OM2P-HS (v1, v2, v3)
  • OM2P-LC
  • OM5P
  • OM5P-AN
  • OM5P-AC (v1, v2) [1]
• TP-Link
  • Archer C5 (v1) [1]
  • Archer C7 (v2, v4) [1]
  • CPE210 (v1.0, v1.1)
  • CPE220 (v1.1)
  • CPE510 (v1.0, v1.1)
  • CPE520 (v1.1)
  • RE450 [1]
  • TL-WDR3500 (v1)
  • TL-WDR3600 (v1)
  • TL-WDR4300 (v1)
  • TL-WR710N (v1, v2.1)
  • TL-WR842N/ND (v1, v2, v3)
  • TL-WR1043N/ND (v1, v2, v3, v4, v5)
  • TL-WR2543N/ND (v1)
  • WBS210 (v1.20)
  • WBS510 (v1.20)
• Ubiquiti
  • Air Gateway
  • Air Gateway LR
  • Air Gateway PRO
  • Air Router
  • Bullet M2/M5
  • Loco M2/M5
  • Loco M2/M5 XW
  • Nanostation M2/M5
  • Nanostation M2/M5 XW
  • Picostation M2/M5
  • Rocket M2/M5
  • Rocket M2/M5 Ti
  • Rocket M2/M5 XW
  • UniFi AC Mesh [1]
  • UniFi AP
  • UniFi AP AC Lite [1]
  • UniFi AP AC Pro [1]
  • UniFi AP LR
  • UniFi AP Pro
  • UniFi AP Outdoor
  • UniFi AP Outdoor+
• Western Digital
  • My Net N600
  • My Net N750

[1]	(1, 2, 3, 4, 5, 6, 7, 8, 9) Device uses the ath10k WLAN driver; no image is built unless GLUON_ATH10K_MESH is set as described in Make variables

ar71xx-nand

• Netgear
  • WNDR3700 (v4)
  • WNDR4300 (v1)

ar71xx-tiny

• D-Link
  • DIR-615 (C1)
• TP-Link
  • TL-MR13U (v1)
  • TL-MR3020 (v1)
  • TL-MR3040 (v1, v2)
  • TL-MR3220 (v1, v2)
  • TL-MR3420 (v1, v2)
  • TL-WA701N/ND (v1, v2)
  • TL-WA730RE (v1)
  • TL-WA750RE (v1)
  • TL-WA801N/ND (v1, v2, v3)
  • TL-WA830RE (v1, v2)
  • TL-WA850RE (v1)
  • TL-WA860RE (v1)
  • TL-WA901N/ND (v1, v2, v3, v4)
  • TL-WA7210N (v2)
  • TL-WA7510N (v1)
  • TL-WR703N (v1)
  • TL-WR710N (v1, v2, v2.1)
  • TL-WR740N (v1, v3, v4, v5)
  • TL-WR741N/ND (v1, v2, v4, v5)
  • TL-WR743N/ND (v1, v2)
  • TL-WR841N/ND (v3, v5, v7, v8, v9, v10, v11, v12)
  • TL-WR843N/ND (v1)
  • TL-WR940N (v1, v2, v3, v4, v5, v6)
  • TL-WR941ND (v2, v3, v4, v5, v6)

brcm2708-bcm2708

• RaspberryPi 1

brcm2708-bcm2709

• RaspberryPi 2

mpc85xx-generic

• TP-Link
  • TL-WDR4900 (v1)

x86-generic

• x86-generic
• x86-virtualbox
• x86-vmware

See also: x86 support

x86-geode

• x86-geode

See also: x86 support

x86-64

• x86-64-generic
• x86-64-virtualbox
• x86-64-vmware

See also: x86 support

License

See LICENCE

Indices and tables

• Index
• Search Page