--- --- The Configuration file ====================== == The Configuration file The configuration file placed on **/etc/config/lime** is one of the key points for LibreMesh. It contains a set of basic options which are used by Libre Mesh backend to perform its magic. The special program **lime-config** reads such file and applies the configuration to the operating system. The default options (those which are not defined by the user in the config file) are read from **/etc/config/lime-defaults**, however it should not be modified in runtime. Some options are parametrizable with a set of special characters which will be substituted for some specific node data. . **MAC bytes** [%Mn] refers to the MAC address of the primary interface. Example from CA:FF:EE:BA:BB:EE %M1=CA and %M4=BA . **Network Identifier** [%Nn] refers to the cloud identifier byte which is a hash of the AP SSID. . **Hostname** [%H] Refers to the hostname of the node [NOTE] ============== Note that there is no need to manual configure any of the config file options unless you know what are you doing. In most of the scenarios the default options defined in lime-defaults should work fine. ============== === List of sections and options For updated information check the https://github.com/libremesh/lime-packages/blob/develop/packages/lime-docs/files/lime-example[lime-example] file. .System options ---- config lime system option hostname 'LiMeNode-%M4%M5%M6' option keep_on_upgrade 'libremesh base-files-essential /etc/sysupgrade.conf' ---- .Network general options ---- config lime network option primary_interface eth0 option bmx6_over_batman option main_ipv4_address '192.0.2.0/24' option main_ipv6_address '2001:db8::%M5:%M6/64' option bmx6_mtu '1398' list protocols adhoc list protocols lan list protocols anygw list protocols batadv:%N1 list protocols bmx6:13 # list protocols static:192.168.100.2/24 # list protocols olsr:14 # list protocols olsr6:15 # list protocols olsr2:16 # list resolvers 141.1.1.1 # list resolvers 2001:4860:4860::8844 ---- [NOTE] .main_ipv4_address ================ Here you have 4 possibilities: . set a static IP and the subnet, like '192.0.2.1/16' . parametrize with %Mn and %Nn, and set the subnet, like '192.%N1.%M5.%M6/16'; . set a whole network address (so not a specific IP) for getting the IP autocompleted in that network with bits from MAC address, this works also with netmasks other than /24 or /16, like '192.0.128.0/17' . set two different parameters, the first for subnet and the second for IP parametrization, like '192.0.128.0/16/17', this results in /16 subnet but IP parametrized in a /17 range. ================ [NOTE] .main_ipv6_address ================ Parametrizable in the same way as main_ipv4_address. If used, the IP autocompletion will fill maximum the last 24 bits, so specifying an IP autocompletion range bigger than /104 is not useful. ================ [NOTE] .list protocols ================ List of protocols configured by LibreMesh, some of these require the relative package "lime-proto-...". Note that if you set here some protocols, you overwrite the **whole** list of protocols set in /etc/config/lime-defaults. ================ .WiFi general options ---- config lime wifi option country 'ES' option channel_2ghz '11' option channel_5ghz '48' option htmode_2ghz 'HT20' option htmode_5ghz 'HT40' list modes 'ap' list modes 'apname' list modes 'adhoc' # list modes 'ieee80211s' option ap_ssid 'libremesh.org' option apname_ssid 'libremesh.org/%H' option adhoc_ssid '%H' option adhoc_bssid 'ca:fe:00:c0:ff:ee' option adhoc_mcast_rate_2ghz '24000' option adhoc_mcast_rate_5ghz '6000' # option mesh_mesh_fwding '0' # option mesh_mesh_id 'LiMe' ---- [NOTE] .wifi options ============= Any option with name _