Build system (Yocto)
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:
Software | Recipe | Publisher |
|---|---|---|
LORIX Manager | manager | Wifx |
LORIX Manager UI | manager-gui | Wifx |
| Process Monitor | pmonitor | Wifx |
| Process Monitor CLI | pmcli | Wifx |
| Process Supervisor | pvisor | Wifx |
| UDP Packet Forwarder | udp-packet-forwarder | Wifx |
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.