The LORIX OS is built in a reproductible way using the Yocto Build System.

The sources of the Build System are available on Github on the https://github.com/Wifx/lorix-os repository.

Build LORIX OS


The Build System documentation is available in the LORIX OS repository README.

Customize LORIX OS

LORIX OS can be customized to have an alternative configuration or to embed additional software. This is done by modifying the Yocto recipes provided.

To do so, you will have to learn the basics of the Yocto build system. As this is a standard tool, we will not document deeply how it works in this documentation. Please refer to the official Yocto documentation for further details.

If you start customizing LORIS OS, please be sure to never edit the existing layers but to add your own, overriding the default behavior.

Additional guides will be added over time to this page to show how to do some basic tasks such as:

  • Adding new software
  • Adding new configurations for existing software (e.g. frequency plans)
  • Change the default configuration of the gateway

Closed source assets

Even though the build system is Open Source, some of the applications shipped with LORIX OS are not. The following software is not Open Source:

SoftwareRecipePublisher

LORIX Manager

managerWifx

LORIX Manager UI

manager-guiWifx
Process MonitorpmonitorWifx
Process Monitor CLIpmcliWifx
Process SupervisorpvisorWifx
UDP Packet Forwarderudp-packet-forwarderWifx

Therefore, those software are provided as compiled assets fetched from the official download repository during the build: https://download.wifx.net/yocto/sources/lorix-os/packages-assets/.

This is done automatically during the Yocto build.