Skip to content

docs: Add initramfs day two options and future - #2415

Draft
jmarrero wants to merge 2 commits into
bootc-dev:mainfrom
jmarrero:docs/initramfs-day-2
Draft

docs: Add initramfs day two options and future#2415
jmarrero wants to merge 2 commits into
bootc-dev:mainfrom
jmarrero:docs/initramfs-day-2

Conversation

@jmarrero

Copy link
Copy Markdown
Contributor

No description provided.

Signed-off-by: Joseph Marrero Corchado <jmarrero@redhat.com>
@bootc-bot
bootc-bot Bot requested a review from ckyrouac August 26, 2026 19:39
@github-actions github-actions Bot added the area/documentation Updates to the documentation label Aug 26, 2026
Comment thread docs/src/initramfs.md
Comment on lines +9 to +10
Some systems need machine-specific initramfs content after installation, such
as a udev rule required to unlock local storage. Until `bootc` has a dedicated

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Well the details of what one wants to do in the initramfs matter a lot here.

Like, does the udev rule itself actually need to be machine specific?

A general pattern that also works is to have "machine specific" configuration embedded in generic images that dispatches on machine specific identifiers hardware MAC addresses are a classic option, but not the only one.

Comment thread docs/src/initramfs.md

COPY 98-thunderbolt.rules /etc/udev/rules.d/98-thunderbolt.rules

RUN set -eu; \

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

This is operating system specific, I think we should just link to https://docs.fedoraproject.org/en-US/bootc/initramfs/

Comment thread docs/src/initramfs.md
Comment on lines +51 to +58
Build the image locally, then stage it through the Podman container storage:

```console
$ sudo podman build --security-opt=label=disable --pull=newer \
--tag localhost/machine-bootc:latest .
$ sudo bootc switch --transport containers-storage localhost/machine-bootc:latest
$ sudo systemctl reboot
```

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Do we need to duplicate these instructions vs just referencing the booting-local-builds.md?

Comment thread docs/src/initramfs.md
whenever either the base image or the machine-specific initramfs configuration
changes. A systemd service and timer can automate the rebuild if required.

### Automate the local build

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

This is a fully generic instruction that I think makes more sense in the booting-local-builds.md

BTW, the real problem with this is correct change detection; if you don't have reproducible builds then you're going to be pointlessly rebooting your machine some days...

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