Files
zosbuilder/components/rfs/frontend/README.md
Jan De Landtsheer bf62e887e8 feat: Create minimal Zero-OS initramfs with console support
- Fixed build system to clone source repositories instead of downloading binaries
- Enhanced scripts/fetch-github.sh with proper git repo cloning and branch handling
- Updated scripts/compile-components.sh for RFS compilation with build-binary feature
- Added minimal firmware installation for essential network drivers (73 modules)
- Created comprehensive zinit configuration set (15 config files including getty)
- Added util-linux package for getty/agetty console support
- Optimized package selection for minimal 27MB initramfs footprint
- Successfully builds bootable vmlinuz.efi with embedded initramfs
- Confirmed working: VM boot, console login, network drivers, zinit init system

Components:
- initramfs.cpio.xz: 27MB compressed minimal Zero-OS image
- vmlinuz.efi: 35MB bootable kernel with embedded initramfs
- Complete Zero-OS toolchain: zinit, rfs, mycelium compiled from source
2025-08-16 23:25:59 +02:00

1.1 KiB

Threefold RFS

Description

Threefold RFS is a frontend that helps manage the RFS server for creating, mounting, and extracting FungiStore lists, or fl for short. An fl is a simple format that stores information about a whole filesystem in a compact way. It doesn't hold the actual data but includes enough details to retrieve the data from a store.

Prerequesites

  • build essentials

    sudo apt-get install build-essential
    
  • node js

  • rust

  • Cargo, to be configured to run in the shell

  • musl tool

        sudo apt install musl-tools
    

Installation

    git clone https://github.com/threefoldtech/rfs.git

backend

Please check rfs server

frontend

  • Move to frontend directory, open new terminal and execute the following commands to run the frontend:

        npm install
        npm run dev
    

Usage

  • Login with users listed in config.toml with their username and password
  • Create Flist
  • Preview Flist
  • List all Flists
  • Download Flist