Skip to content

Conversation

@cgwalters
Copy link
Collaborator

Users doing bootc install to-existing-root previously had no easy way to find the ostree deployment before rebooting in order to inject configuration files. This addresses that gap.

Key changes:

  • Document using ostree admin --print-current-dir to find the newly created deployment path before rebooting
  • Clarify the two distinct scenarios: injecting new configuration before reboot vs. migrating old data after reboot
  • Add examples for both file-based configuration and kernel arguments (via systemd.mount-extra)
  • Cross-link documentation between general install docs and the to-existing-root man page
  • Fix typo in path structure documentation

Related: #531

Assisted-by: Claude Code (Sonnet 4.5)

Users doing `bootc install to-existing-root` previously had no easy
way to find the ostree deployment before rebooting in order to inject
configuration files. This addresses that gap.

Key changes:

- Document using `ostree admin --print-current-dir` to find the newly
  created deployment path before rebooting
- Clarify the two distinct scenarios: injecting new configuration
  before reboot vs. migrating old data after reboot
- Add examples for both file-based configuration and kernel arguments
  (via `systemd.mount-extra`)
- Cross-link documentation between general install docs and the
  to-existing-root man page
- Fix typo in path structure documentation

Related: bootc-dev#531

Assisted-by: Claude Code (Sonnet 4.5)
Signed-off-by: Colin Walters <walters@verbum.org>
@github-actions github-actions bot added the area/documentation Updates to the documentation label Nov 21, 2025
@bootc-bot bootc-bot bot requested a review from jmarrero November 21, 2025 18:46
@cgwalters cgwalters marked this pull request as ready for review November 21, 2025 18:46
Copy link
Contributor

@jmarrero jmarrero left a comment

Choose a reason for hiding this comment

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

lgtm

@cgwalters cgwalters enabled auto-merge (rebase) November 21, 2025 18:57
@cgwalters cgwalters merged commit 99123ba into bootc-dev:main Nov 21, 2025
45 of 49 checks passed
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.

2 participants