LibreMesh packages

LibreMesh project includes the development of several tools used for deploying libre/free mesh networks.

The firmware (the main piece) will allow simple deployment of auto-configurable, yet versatile, multi-radio mesh networks. Check the Network Architecture to see the basic ideas.

We encourage each network community to create its firmware profile on network-profiles repository and build the images locally.

Supported hardware

In this page we provide a list of requirements that ensure you to have a working LibreMesh node on your router. This list comes with no warranties: read carefully the model-specific instructions on OpenWrt wiki and be extra-careful when flashing your routers!

Building a Firmware Image on Your PC

The LibreMesh firmware can be compiled by following these instructions.

Using the ImageBuilder

Start an ImageBuilder of your choice, use containers for an easier setup:

mkdir ./images/
docker run -it -v $(pwd)/images:/images/ ghcr.io/openwrt/imagebuilder:ath79-generic-v22.03.4

Within the container, add the lime-packages feed:

echo "src/gz libremesh https://feed.libremesh.org/master" >> repositories.conf
echo  "untrusted comment: signed by libremesh.org key a71b3c8285abd28b" > keys/a71b3c8285abd28b
echo "RWSnGzyChavSiyQ+vLk3x7F0NqcLa4kKyXCdriThMhO78ldHgxGljM/8" >> keys/a71b3c8285abd28b

Ideally add your own lime-community files within the container in the folder ./files/etc/config/. To find possible options consult the lime-example.txt file. It is also possible to mount an existing lime-community file directly via -v $(pwd)/lime-community:/builder/files/etc/config/lime-community.

Now create an image of your choice, to see the names of supported profiles run make info first.

make image PROFILE=ubnt_unifi PACKAGES="lime-system lime-proto-babeld" BIN_DIR=/images FILES=files

Your images should be available outside of the container in the ./images/ folder

Testing

LibreMesh has unit tests that help us add new features while keeping maintenance effort contained.

To run the tests simply execute ./run_tests.

Please read the [Unit Testing Guide] for more details about testing and how to add tests to LibreMesh.

Get in Touch with LibreMesh Community

Mailing Lists

The project has an official mailing list [email protected] and an Element (#libremesh-dev:matrix.guifi.net) chat room; check out this page with the links for joining the chatroom.

Contributors

This project exists thanks to all the people who contribute. [Contribute].

Donations

We are now a member of open collective, please consider a small donation!

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]