Skip to content

Link bootc custom #4346

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 29, 2025
Merged

Link bootc custom #4346

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 7 additions & 19 deletions docs/custom.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
<https://docs.fedoraproject.org/en-US/fedora-coreos/faq/#_how_does_fedora_coreos_relate_to_fedora_bootc>.
Loading