meta-derivative

This is an example project for how derivative distributions can be made using the meta-moonforge Yocto layer.

Check this tutorial for how this derivative example was made from scratch.

Setup

The host requirements are:

• docker or podman
• python3-pip

See the official documentation for common Linux distributions like Fedora or Ubuntu.

Install the necessary tooling to run kas:

$ pip install --user kas==5.0
$ kas-container --help

Create a workspace directory, needed to hold the persistent cache, and clone this repository:

$ mkdir workspace && cd workspace
$ mkdir cache
$ git clone https://github.com/moonforgelinux/meta-derivative.git

Build

Set up cache directories to speed up subsequent builds:

$ cd meta-derivative
$ export KAS_CONTAINER_ENGINE=docker
$ export DL_DIR=$PWD/../cache/downloads/
$ export SSTATE_DIR=$PWD/../cache/sstate-cache/

Use kas-container to build the image:

$ cd meta-derivative
$ kas-container build kas/derivative-image-base-raspberrypi5.yml

Test

Once the image is successfully built use a tool like bmaptool to flash the SD card:

$ cd meta-derivative
$ sudo bmaptool copy ./build/tmp/deploy/images/raspberrypi5/moonforge-image-base-raspberrypi5.rootfs.wic.bz2 /dev/sdX

Legal

MIT License

Copyright (c) 2026 Igalia, S.L.