mos_images

What this is

Boot image assets and operating system image builders for MyceliumOS. This repository contains the kernel and initramfs binaries used at boot time, as well as scripts and tooling to build Ubuntu 24.04 VM images with systemd and hero-init for use on the ThreeFold Grid.

What this repository contains

mos_images/
├── boot/
│   ├── vmlinuz               # Linux kernel binary
│   └── initrd.img            # Initial ramdisk image
└── ubuntu_24.04/
    ├── ubuntu24-zinit-flist-builder.sh  # Ubuntu 24.04 image builder script
    ├── hero-init                          # VM initialization binary
    └── README.md                          # Detailed builder documentation

Boot assets (boot/)

The vmlinuz and initrd.img files are the kernel and initial ramdisk used by MyceliumOS nodes at boot. The initramfs contains the boot-critical components: my_init (PID 1 supervisor), mosnet (network bring-up), myfs (firmware and module flist delivery), and mos_sysvol (persistent storage initialization).

Ubuntu 24.04 image builder (ubuntu_24.04/)

A script that creates an Ubuntu 24.04 image using systemd as the init system and hero-init for VM initialization (similar to cloud-init). The image is packaged as a compressed archive and uploaded to the ThreeFold Grid hub as an flist.

Key features of the built image:

• systemd as PID 1
• hero-init as a systemd oneshot service that runs early in boot
• SSH service enabled
• btrfs root filesystem with zstd compression and subvolumes

See ubuntu_24.04/README.md for full builder documentation.

Role in the stack

mos_images provides the boot-time and VM images required by MyceliumOS. The boot kernel/initrd pair is used by the node firmware to start the system, while the Ubuntu 24.04 image builder produces VM images that run on the ThreeFold Grid with Mycelium overlay network integration.

The boot-critical chain uses these assets:

kernel (vmlinuz) → initramfs (initrd.img) → /init → my_init → mosnet → myfs → mos_sysvol → runtime services

Relation to ThreeFold

This technology is used within the ThreeFold ecosystem and was first deployed on the ThreeFold Grid. The component itself is designed as reusable infrastructure technology and should be understood by its technical function first, independent of any specific deployment.

Ownership

This repository is owned and maintained by TF-Tech NV, a Belgian company responsible for the development and maintenance of this technology.

License

This project is licensed under the Apache License 2.0 — see the LICENSE file for details.