Mesh Node HOWTO

Following are instructions to set up a mesh-networking node in Debian. This guide assumes Debian Stable, jessie or later. If you are unsure of which release of Debian you are using, try the command lsb_release -a

Set up hardware

First you will need to verify that your radio supports mesh mode or IBSS mode. These two modes are the new version of what used to be called "Repeater" and "Ad Hoc" modes. No mode called "Ad Hoc" exists any more in the

iw

tool.

iwconfig

in Jessie still supports Ad-Hoc mode. https://wireless.wiki.kernel.org/en/users/drivers uses the mesh / IBSS terminology, so this guide will standardize on that.

The difference between the two modes

From the

iwconfig

man page:

             The mode can be Ad-Hoc (network composed of only
             one cell and without Access Point), Managed (node connects to  a
             network  composed  of  many Access Points, with roaming), Master
             (the node is the synchronisation master or  acts  as  an  Access
             Point),  Repeater (the node forwards packets between other wire‐
             less  nodes),  Secondary  (the  node  acts  as  a  backup   mas‐
             ter/repeater), Monitor (the node is not associated with any cell
             and passively monitor all packets on the frequency) or Auto.

Firmware

Once you have verified that your radio hardware supports the requisite mode, you must ensure that the correct firmware is installed to make it work properly. Some radios will still work with limited functionality without the correct firmware file installed, which can be confusing.

Setting up services

When you have verified that the