Appearance

Getting Started ​

Installation ​

Prerequisites ​

Check the Table of Hardware to see if your device is supported by OpenWrt.

NOTE

It is recommended that the router has at least:

  • 16 MB of flash memory and 128 MB of RAM.
  • 1 radio working at 2.4GHz radio and 1 at 5GHz

It is possible to install LibreMesh on routers with 8 MB of flash and 64 MB of RAM
Read the OpenWrt's 8/64 warning and refers to the page packages selection for build customization.

CAUTION

Ensure to have read the OpenWrt's wiki page for of your device.
Read the installation instruction and ensure to have the necessary hardware equipment - if needed on your device - to install the firmware, like an USB-UART/Serial adapter and/or an USB-JTAG adapter

Download the firmware ​

Download using the Firmware Selector
The Firmware Selector request a firmware build via an ASU (online ImageBuilder) instance.

https://firmware-selector.libremesh.org

Download old precompiled versions
Old releases archive with pre-compiled firmwares via Buildroot are available at:

https://firmware-libremesh.antennine.org

Build LibreMesh on your host
Refers the the page Build LibreMesh for instructions on how to build LibreMesh on your host.

Install the firmware ​

Install the firmware on your device following the installation method reported in the wiki of OpenWrt or, if not present, search the instruction in the git-commit message left from who added the support for that device model. See the Table of Hardware.

https://openwrt.org/docs/guide-quick-start/factory_installation

NOTE

It is strongly adviced to install OpenWrt first:

  1. Download the latest stable firmware for your device from the OpenWrt Firmware Selector.
    If your device runs OEM firmware use the factory for first time installation.
  2. Check that the OpenWrt device boot and function properly.
    Beware that OpenWrt by default doesn't turn on the Wi-Fi.
    Turn it on from LuCi from the menu Network / Wireless.
  3. Upgrade to LibreMesh:
    • upload the firmware via the web interface LuCI from the menu System / Backup / Flash Firmware.
    • or via ssh using the command sysupgrade -n firmware.bin

Connecting to the router ​

The router could be reached via web at http://thisnode.info.
See the page Connecting to the router for detailed options and troubleshooting

Configuration ​

LibreMesh come with a default flavor which works out of the box without requiring a manual configuration.

See the page configuration for detailed options.

Maintenance ​

Install newer OpenWrt stable releases to keep updated the device:

Refers to the page Upgrade for recommended operations with LibreMesh.