getit.txt

---
title: Get it!
ref: get_it
lang: en
---

== Download it: The firmware selector

At this page you can search for your router model and download the adequate file

https://repo.libremesh.org/selector/

[NOTE]
=========================
You will need the "factory" file for the first installation from the vendor firmware. Or the "sysupgrade" file for replacing OpenWrt or for upgrading from an older LibreMesh version. When upgrading, make sure to **not** keep the previous configuration.
=========================

[IMPORTANT]
=========================
If you cannot find your router model, please select the `-mini` version from the list of the available LibreMesh versions and search again. If you cannot find your router neither like this, 
=========================

== Build it online: The firmware selector with custom packages

After selecting the LibreMesh version and the router model on the https://repo.libremesh.org/selector[LibreMesh firmware selector page], you will see a "Customize installed packages and/or first boot script" button. Click it and you will be able to add or remove packages to the firmware.

Also, you can add custom configuration adding the package of a https://libremesh.org/development-network_profiles.html[network profile] (for example, the package of the network profile for the "calafou" community and the "indoor2" type will be named `profile-calafou-indoor2`).

Additionally, you can add BASH commands to be run just after flashing the LibreMesh firmware in the "Script to run on first boot (uci-defaults)" section.

When you are happy with the settings, press "Request build" and the system will compile a new LibreMesh image just for you!

== Build it locally: The OpenWrt buildroot with the LibreMesh modules

Refer to the link:development.html[Development] page, use the v2024.1 tag and use OpenWrt 23.05.5 for compiling the latest release: *LibreMesh 2024.1 Fantastic Forwarder*.

== Old versions

For finding all the LibreMesh firmware images, including old versions, check out this page:

https://repo.libremesh.org/

To find the right file to use, please refer to the OpenWrt wiki, see their link:https://openwrt.org/toh/start[Table of Hardware here].

== Installation procedure

For installation procedure read our link:docs/en_quick_starting_guide.html[Quick Starting Guide].