Skip to content

Conversation

@cgwalters
Copy link
Collaborator

@cgwalters cgwalters commented Jan 22, 2026

The composefs backend implementation has largely landed. Consolidate tracking of known issues into the docs, categorized by severity:

  • Deployment blockers: GC, SELinux enforcing=0, OCI registry install
  • Important: Sealed image build UX, kargs.d support
  • Long-term: Unified storage, UKI/systemd-boot improvements

Closes: #1190

Assisted-by: OpenCode (Opus 4.5)

@github-actions github-actions bot added the area/documentation Updates to the documentation label Jan 22, 2026
@bootc-bot bootc-bot bot requested a review from jeckersb January 22, 2026 17:53
The composefs backend implementation has largely landed. Consolidate
tracking of known issues into the docs, categorized by severity:

- Deployment blockers: GC, SELinux enforcing=0, OCI registry install
- Important: Sealed image build UX, kargs.d support
- Long-term: Unified storage, UKI/systemd-boot improvements

This allows closing the original tracking issue bootc-dev#1190.

Assisted-by: OpenCode (Claude Sonnet 4)
Signed-off-by: Colin Walters <walters@verbum.org>
@cgwalters cgwalters force-pushed the composefs-tracker-cleanup branch from 985899f to 9eebda0 Compare January 22, 2026 17:53
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request refactors the composefs documentation by moving the list of known issues from a GitHub tracking issue into the markdown file itself. The changes are well-structured, categorizing issues into deployment blockers, important items, and long-term goals, which significantly improves clarity. My review includes a couple of suggestions to further enhance the completeness and consistency of the documentation.

- **SELinux**: Currently uses `enforcing=0` in the kernel command line (see [#1826](https://github.com/bootc-dev/bootc/issues/1826))
- **kargs.d**: Custom kernel arguments from `/usr/lib/bootc/kargs.d` are not yet automatically included in sealed UKIs
- [Sealed image build UX](https://github.com/bootc-dev/bootc/issues/1498): Streamlined tooling for building sealed images
- **kargs.d**: Custom kernel arguments from `/usr/lib/bootc/kargs.d` not yet included in sealed UKIs
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The use of bold formatting for the kargs.d item is inconsistent with the other items in this list, which are either links or plain text. For better visual consistency, I suggest removing the bolding.

Suggested change
- **kargs.d**: Custom kernel arguments from `/usr/lib/bootc/kargs.d` not yet included in sealed UKIs
- kargs.d: Custom kernel arguments from `/usr/lib/bootc/kargs.d` not yet included in sealed UKIs

- [#1826](https://github.com/bootc-dev/bootc/issues/1826) - SELinux enforcement with composefs
- [#20](https://github.com/bootc-dev/bootc/issues/20) - Unified storage (long-term goal)
- [#806](https://github.com/bootc-dev/bootc/issues/806) - UKI/systemd-boot tracker
- [Unified storage](https://github.com/bootc-dev/bootc/issues/20)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

It appears the tracker for UKI/systemd-boot improvements (#806) was omitted from the new 'Known Issues' section. The PR description mentions this as a long-term goal, and it was present in the old 'Related Issues' list. It would be good to include it here for completeness.

Suggested change
- [Unified storage](https://github.com/bootc-dev/bootc/issues/20)
- [Unified storage](https://github.com/bootc-dev/bootc/issues/20)
- [UKI/systemd-boot improvements](https://github.com/bootc-dev/bootc/issues/806)

We need some work in e.g. bcvk among others to have this work.

Closes: bootc-dev#1940
Signed-off-by: Colin Walters <walters@verbum.org>
- **SELinux**: Currently uses `enforcing=0` in the kernel command line (see [#1826](https://github.com/bootc-dev/bootc/issues/1826))
- **kargs.d**: Custom kernel arguments from `/usr/lib/bootc/kargs.d` are not yet automatically included in sealed UKIs
- [Sealed image build UX](https://github.com/bootc-dev/bootc/issues/1498): Streamlined tooling for building sealed images
- **kargs.d**: Custom kernel arguments from `/usr/lib/bootc/kargs.d` not yet included in sealed UKIs
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can only happen with UKI addons as we can not modify the kargs of signed UKIs

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Right, but this is about automatically inserting those kargs when generating a UKI at build time.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/documentation Updates to the documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

bootc composefs-native backend

2 participants