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 OSLink to Build LORIX OS


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

Customize LORIX OSLink to 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 assetsLink to 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:

Software
Recipe
Publisher

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.



Was this page helpful for you?

Yes
No
Fix it