mirror of
https://git.disroot.org/pranav/pybatmesh.git
synced 2025-01-09 08:23:58 +05:30
84 lines
2.3 KiB
Markdown
84 lines
2.3 KiB
Markdown
# naxalnet
|
|
|
|
Naxalnet is an experiment to create an intranet and use it for
|
|
communicating during an internet shutdown. It tries to use
|
|
existing software and tech as much as possible. Currently
|
|
you can only communicate with other peers running the same software.
|
|
|
|
The name naxal comes from Naxalbari, a village in Darjeeling,
|
|
West Bengal.
|
|
|
|
<!-- UNCOMMENT WHEN NECESSARY
|
|
|
|
**Disclaimer**:
|
|
In case you are either 1) a complete idiot; or 2) a member of parliament in
|
|
India; or 3) both, please be aware that this project is not affiliated with
|
|
any groups designated as terrorist groups in India.
|
|
|
|
Using the name Naxal does not imply any form of connection
|
|
with anyone the government collectively calles Urban Naxals (human rights
|
|
activists, lawyers, poets, writers, journalists or anyone else
|
|
advocating the constitutional rights).
|
|
|
|
-->
|
|
|
|
## Requirements
|
|
|
|
* systemd v248 or more (for batman support)
|
|
* Linux kernel with batman-adv module (if `modinfo batman-adv` shows no error
|
|
then you already have it)
|
|
* iwd (for starting ad-hoc network)
|
|
* wifi adapter with ad-hoc support
|
|
* two or more computers with wifi adapter
|
|
|
|
## Installing
|
|
|
|
### Manually
|
|
|
|
Run `sudo make install` to install naxalnet. This will install naxalnet in
|
|
`/usr/{bin/naxalnet,share/naxalnet/,lib/systemd/system/naxalnet@.service}`.
|
|
|
|
To install in /usr/local instead, use `sudo make install PREFIX=/usr/local`.
|
|
|
|
After installing, reload systemd so that you can enable `naxalnet@.service`
|
|
without rebooting:
|
|
```
|
|
sudo systemctl daemon-reload
|
|
```
|
|
|
|
## Running the program
|
|
|
|
Any network managers such as NetworkManager and wifi daemons like
|
|
wpa_supplicant should be disabled:
|
|
|
|
```
|
|
sudo systemctl disable --now NetworkManager wpa_supplicant
|
|
```
|
|
|
|
Enable the naxalnet service on the device `wlan0` (iwd replaces interface
|
|
names like wlp1s0 with wlan0):
|
|
```
|
|
sudo systemctl enable --now naxalnet@wlan0.service
|
|
```
|
|
Now naxalnet will configure a batman interface on every boot.
|
|
|
|
## Uninstalling
|
|
|
|
Currently there is now way to uninstall naxalnet than to manually removing
|
|
the files:
|
|
```
|
|
sudo rm /usr/{bin/naxalnet,share/naxalnet/,lib/systemd/system/naxalnet@.service}
|
|
```
|
|
Or if you installed naxalnet in /usr/local:
|
|
```
|
|
sudo rm /usr/local/{bin/naxalnet,share/naxalnet/,lib/systemd/system/naxalnet@.service}
|
|
```
|
|
|
|
## TODO
|
|
|
|
- add support for wireless ap (WiFi hotspot)
|
|
|
|
Add list of things here.
|
|
|
|
This project is in pre-alpha stage. Documentation is incomplete.
|