F40 Change Proposal: Arm Minimal Image OS-Build (Self-Contained)

This is a proposed Change for Fedora Linux.
This document represents a proposed Change. As part of the Changes process, proposals are publicly announced in order to receive community feedback. This proposal will only be implemented if approved by the Fedora Engineering Steering Committee.



Build the Arm minimal image to be built using osbuild.

:link: Owner

:link: Detailed Description

The Fedora Arm Minimal image is widely used as a base for various usecases from low level board bring up right through to the basis of other images. Over time the existing ImageFactory build process has stagnated limiting our ability to enhance this image. The osbuild team have worked with the Arm SIG to enable a number of enhancements around things like Arm SystemReady and other such functionality to improve this image creation process and to make it easier to use these images with a much wider range of Arm devices making it easier to bring up new types of Arm device in Fedora. In the future we are planning further enhancements to ensure it’s easy for developers and users to make use of the Fedora within the Arm ecosystem.

:link: Feedback

:link: Benefit to Fedora

The Fedora arm Minimal Image currently requires a number of changes and hacks to be used on specific devices or SoCs, the move to osbuild will reduce or entirely eliminate these hacks right away with further enhancements coming in the future.

:link: Scope

  • Proposal owners:

The proposal owners will:

    • Enable the creation of Minimal image using osbuild in pungi
    • Test the available artifacts
  • Other developers:

  • Release engineering: #Releng issue number

Changes to the pungi config to use osbuild for minimal image will be submitted as a PR by feature owners.

  • Policies and guidelines: N/A (not needed for this Change)

  • Trademark approval: N/A (not needed for this Change)

  • Alignment with Community Initiatives:

:link: Upgrade/compatibility impact

No upgrade impact. Only for new users.

:link: How To Test

There will be a new Minimal Image, it will be testable in the same way as the old image. Test various SoCs with arm-image-installer to ensure devices boot and run as expected.

:link: User Experience

There should be no change to the user experience for existing users. We will enable the wider use of

:link: Dependencies

All changes are already in osbuild but we will work with the osbuild team if any issues arise.

:link: Contingency Plan

The contingency plan is to build the Arm minimal image in the same way we currently do.

:link: Documentation

There should be no changes required to documentation for existing users, docs will be updated for specific devices where enhancements have been made.

:link: Release Notes


Is there a repository where the blueprint for the minimal image will be stored? Otherwise there’s not exactly anything Fedora side that anyone can actually observe, extend, or maintain.

At the moment no, because the minimal image hasn’t changed in years, but we will be introducing that for the other images in a future release. This is currently focused on Minimal just to get the full process in place and issues ironed out.

This change proposal has now been submitted to FESCo with ticket #3158 for voting.

To find out more, please visit our Changes Policy documentation.

That doesn’t obviate the need for the blueprint, since the community should know how it is made in a way that they can see what defines it, especially if they want to customize/extend it.