Rugix Apps Examples

This repository contains Rugix Apps examples that can be built into Rugix app bundles with rugix-bundler. They range from a small web-server starter app to industrial edge workloads.

Rugix is an open-source toolkit for building and maintaining robust Linux-powered products. Rugix Apps is part of its on-device application lifecycle support; fleet management, remote access, and rollout orchestration remain the responsibility of a separate fleet management solution.

The industrial examples focus on device-local workloads such as protocol translation, buffering, and process data APIs.

Examples

Example	Pattern	Main components
python-web-server	Serve a static local page from a minimal Python container.	Python
modbus-mqtt-gateway	Poll a simulated PLC over Modbus TCP and publish normalized MQTT telemetry.	Python, Eclipse Mosquitto
opcua-mqtt-bridge	Read machine values from an OPC UA server and bridge them into MQTT.	asyncua, Python, Eclipse Mosquitto
mqtt-edge-historian	Persist MQTT telemetry locally and expose a small query API.	Python, SQLite, FastAPI, Eclipse Mosquitto

Quick Start

Install the current Rugix Bundler release through mise's GitHub backend:

mise install

Build app bundles in dist/:

mise run build

tools/build-bundles.sh uses Docker on the host to build local helper images before packaging them with Rugix Bundler.

For a fast structural check without bundling container images:

tools/build-bundles.sh --no-images
tools/test.sh

Prebuilt App Bundles

CI builds every example for linux/amd64 and linux/arm64. Pull requests and branch builds expose the bundles as workflow artifacts. A tagged commit also creates a GitHub release containing the bundles.

Release filenames identify both the example and target architecture. For example, the Python web-server assets are:

python-web-server-amd64.rugixb
python-web-server-amd64.rugixb-hash
python-web-server-arm64.rugixb
python-web-server-arm64.rugixb-hash

The hash files contain the Rugix bundle header hashes produced by rugix-bundler hash. Maintainers can create a release by pushing a tag:

git tag v0.1.0
git push origin v0.1.0

VM Testing

The optional VM path uses Rugix Bakery to create a Debian EFI test image with Rugix Ctrl, Docker, Docker Compose, SSH, and network setup.

The bundled vm/run-bakery wrapper pins the latest stable Rugix Bakery release known at the time of writing, v0.9.3. Override it with RUGIX_VERSION or RUGIX_BAKERY_IMAGE when testing a newer Bakery image.

tools/build-test-image.sh
tools/build-bundles.sh
tools/vm-test.sh modbus-mqtt-gateway

Each app has its own pytest module under tests/vm/. The shared fixture boots the VM, uploads the selected app bundle, runs rugix-ctrl apps install, activates generation 1, and waits for rugix-ctrl apps info to report the app as running. The per-app test then checks the workload from inside the app's Docker Compose service.

Run all VM app tests with:

tools/vm-test.sh all

Open Source Status

All selected runtime components are open source. See LICENSES.md for the component/license matrix. Package versions in helper images are kept in each service's requirements.txt.

Support

This repository is covered by Tier 3: Example Integration of the Rugix Support Commitment.