From 7001e347f528c0565b9c70ba502de537d1c23874 Mon Sep 17 00:00:00 2001 From: Colin Walters Date: Mon, 20 Oct 2025 16:18:08 -0400 Subject: [PATCH] custom: Link to bootc I actually ended up on this page when I was wondering about the status of making disk images after a podman build. Update it. Signed-off-by: Colin Walters --- docs/custom.md | 26 +++++++------------------- 1 file changed, 7 insertions(+), 19 deletions(-) diff --git a/docs/custom.md b/docs/custom.md index 10687119f9..dd194388ff 100644 --- a/docs/custom.md +++ b/docs/custom.md @@ -3,24 +3,12 @@ title: Building a custom OS with CoreOS Assembler nav_order: 3 --- -# Using coreos-assembler to build custom FCOS derivatives +# Building custom immutable container-native operating systems -The primary goal of Fedora CoreOS is to be useful directly, and -to have users deploy containers for applications, etc. +Creating custom immutable container-native operating systems is now supported +by the [Fedora bootc project](https://docs.fedoraproject.org/en-US/bootc/getting-started/), +and Fedora CoreOS derives from that project. -Some people and organizations have asked about creating custom -derivatives of Fedora CoreOS using this project. This is supported -on a best-effort basis. Supporting these use cases is not a primary -goal of coreos-assembler, though we try not to purposely break them. -Also note that coreos-assembler is still evolving, and it's likely -that there will occasionally be breaking changes. You should -subscribe to releases to make sure you're aware of these. -That said, we do try to maintain a stable interface between -coreos-assembler and the "source config" repo. - -Maintaining a custom operating system build is a nontrivial undertaking -that you shouldn't take lightly. But we will make efforts to -document changes and keep coreos-assembler relatively stable. - -coreos-assembler is used to build RHEL CoreOS, but coreos-assembler -is not a Red Hat product at the current time. +Please see the bootc documentation for guidance on building custom operating systems; +Fedora CoreOS is focused on a "direct consume" model; see also +.