pybatmesh/README.md

naxalnet

naxalnet is a program to create a wireless mesh network for communicating with each other. It can be useful during an internet shutdown, or to join online classes with a group of laptops. It uses B.A.T.M.A.N. Advanced, an implementation of the B.A.T.M.A.N. routing protocol to communicate with peers. The name naxal comes from Naxalbari, a village in Darjeeling, West Bengal.

WARNING: This program uses an unencrypted network. This means you do not get any more privacy or security than with an open WiFi network.

Requirements

• systemd v248 or more
• Linux kernel with batman-adv module
• iwd
• python
• python-setuptools (for building)
• dasbus
• WiFi adapter with ad-hoc support
• two or more computers, or laptops with WiFi adapter, called nodes
• systemd-resolved (optional, for DNS)
• batctl (optional, for debugging)
• python pip (optional, for uninstalling)

Installing

This program is available in the AUR for Arch users. Building manually for other distributions may not always work.

Arch Linux

Install naxalnet (or naxalnet-git for the development version) from the AUR with your favourite helper:

yay -S naxalnet

Optionally, setup systemd-resolved for DNS if any of the nodes have internet access. Start naxalnet when you need it.

Manually

Clone the repo and cd into it.

git clone https://git.disroot.org/pranav/naxalnet.git
cd naxalnet

Or, if you have an IPFS client running, try:

git clone http://k51qzi5uqu5dlye74be0n9iihwk6sm54vexo7bf7pdr4w811y6mmrcp25djozv.ipns.localhost:8080/naxalnet.git

Now, install naxalnet:

sudo make install

After installing, reload systemd so that it detects the new service files:

sudo systemctl daemon-reload

How to use

You need more than one machine running naxalnet for the connection to work.

Start naxalnet

Though naxalnet can run from the commandline, it was designed to be run as a systemd service. To start naxalnet, do the command on all the nodes:

sudo systemctl start naxalnet.service

This will start a mesh network and connect to all nodes. To test if it works, run sudo batctl n -w and check for nodes. If there are any nodes, your network is up.

Getting internet access

Connect an ethernet cable from a router to any of the peers and start naxalnet. If it was already started, you should renew the DHCP connection of all peers. To do this, type sudo networkctl renew bridge0 on all peers.

Tethering via WiFi AP

If there are two adapters in a peer, naxalnet will start a WiFi ap (also called WiFi hotspot) on one of them.

Connect two WiFi adapters on a device and start naxalnet. Now an ap will be started on one of the adapters. Type naxalnet --print-WiFi to get the WiFi SSID and password.

If you had set up internet access on one of the peers, internet can be accessed from the AP.

Running at boot

To run naxalnet at boot, enable the service on all the nodes:

sudo systemctl enable naxalnet.service

Now naxalnet will start a mesh on every boot. Disable the service to stop running at boot:

sudo systemctl disable naxalnet.service

Stopping the service

sudo systemctl stop naxalnet systemd-networkd systemd-resolved iwd

If your distribution uses NetworkManager, starting naxalnet.service will have stopped it. Start NetworkManager again:

sudo systemctl start NetworkManager.service

Configuration

naxalnet stores its default configuration file in /usr/share/naxalnet/naxalnet.conf. To change how the program behaves, copy it to /etc/naxalnet/naxalnet.conf and edit it:

# Create the directory
sudo mkdir /etc/naxalnet
# Now copy the file
sudo cp /usr/share/naxalnet/naxalnet.conf /etc/naxalnet
# Edit the file with your favourite editor as root
gedit admin:/etc/naxalnet/naxalnet.conf

Also, you can change its behaviour every time you run it using arguments:

naxalnet --help

How it works

There are three modes commonly supported by WiFi adapters - ap (WiFi hotspot), station (for joining WiFi networks) and ad-hoc (for decentralised networks). There are some other modes too, like p2p (WiFi direct), but we won't go into the details.

naxalnet uses two modes - ad-hoc and ap, for connecting to the mesh. naxalnet uses iwd to start an ad-hoc network and configures systemd-networkd to setup a BATMAN Advanced network. If there are two WiFi adapters connected to the machine, naxalnet starts an ad-hoc on one of them and an ap on the other. You can use the ap for connecting mobile phones and other devices to the mesh network.

Read the code to learn the details. See systemd-networkd to see how systemd-networkd configures the network.

Use cases

Online class in remote areas

naxalnet can be used to share connections in remote areas. You need at least one device with internet access.

Internet shutdown

You can communicate with neighbouring devices running naxalnet, using services like IPFS, Jami, Secure Scuttlebutt and others which can work on an intranet. They should be installed on your machine before your friendly democratic government announces an internet shutdown, since you cannot download and install them during a shutdown. When a shutdown occurs, enable naxalnet

Uninstalling

If you installed naxalnet manually, use make uninstall to remove naxalnet and its data files:

sudo make uninstall

This requires python pip to be installed.

Contributing or reporting bugs

See HACKING.md

Similar projects

The following projects are similar to naxalnet, but are not designed to be used in a machine with WiFi adapter. If you live in an area where the materials required for any of them are easily available, consider using them instead of naxalnet.

• LibreMesh: framework for OpenWrt-based firmwares
• disaster.radio: solar-powered communications network

License

naxalnet is free/libre/swatantra and open source software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, eitherversion 3 of the License, or (at your option) any later version.

See LICENSE for the complete version of the license.