Appearance

Configuration ​

lime-files ​

The LibreMesh configuration is mainly done by a set of /etc/config/lime-<level> files. These files can be managed via the OpenWrt UCI or manually edited using vim.
To modify them via the LuCI web interface install luci-app-filemanager.

The options contained in these files are merged and overwritten from the lowest to the highest priority:

/etc/config/
├─ lime-defaults    # DO NOT EDIT, default configuration
├─ lime-community   # community configuration
├─ lime-<MAC>       # node configuration, device specific
├─ lime-node        # node configuration
└─ lime-autogen     # DO NOT EDIT, autogenerated configuration

Sections ​

The configuration is divided into three main sections:

  • config lime system - System options: hostname, domain, root_password
  • config lime network - Network options: ipv4/ipv6, dns resolvers, protocols list, protocols options
  • config lime wifi - Wireless options: modes list, AP/Ad-Hoc/ApUP/80211s options

By default followed by radio band specific configurations

  • config lime-wifi-band 2ghz
  • config lime-wifi-band 5ghz

Optionally followed by interface specific sections, and protocols specific options

  • config net port1
  • config wifi radio0

Interface specific section

Interface specific section have to be included in lime-node or lime-<MAC>.

Optionally followed by other protocols specific, scripts and uci configs, or hardware_modules

  • config bgp_peer peer1
  • config generic_uci_config uhttpd_https
  • config hwd_watchcat periodic_reboot

Parametrizable options ​

Inside lime-files the options marked with Parametrizable with %Mn, %Nn, %H, can include the templates:

  • %Mn: replaced by the n'th byte of the primary_interface MAC
  • %Nn: replaced by the n'th (n = 1..5) network-identifier byte, calculated from the hash of the ap_ssid. All the nodes that form a mesh cloud (share the same ap_ssid) will produce the same value
  • %H: replaced by the hostname

lime-config ​

The command lime-config configures LibreMesh on top of OpenWrt.
Refers to the page lime-config for the details.