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 of your device.
Read the installation instruction and ensure to have the necessary hardware equipment - if needed - to install the firmware, like an USB-UART/Serial adapter and/or an USB-JTAG adapter

Download the firmware ​

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

https://firmware-selector.libremesh.org

Precompiled versions
Old releases archive with pre-compiled firmwares via Buildroot.

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.

NOTE

If your device runs OEM firmware it is adviced to install OpenWrt first:

  1. Download the latest stable firmware for your device from the OpenWrt Firmware Selector.
    Use the factory image for first time installation. See OpenWrt Factory Install: 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 using a squashfs-sysupgrade.bin image:
    • Upload the firmware via the web interface LuCI from the menu System / Backup / Flash Firmware.
    • Or install 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.