feat: support installer boot from USB media on Renesas xHCI hardware#686
Open
nianyush wants to merge 2 commits into
Open
feat: support installer boot from USB media on Renesas xHCI hardware#686nianyush wants to merge 2 commits into
nianyush wants to merge 2 commits into
Conversation
Bundle the Renesas xHCI (USB 3.0) host controller driver into the initramfs and disable PCI reallocation on the installer boot entries so the Palette Edge installer can boot and install from USB media on hardware using that chipset. - Earthfile: write /etc/dracut.conf.d/99-usb-media.conf in base-image before the distro dracut regeneration so xhci_pci_renesas is included in the generated initramfs (add_drivers + force_drivers). - grub.cfg: add pci=realloc=off to the installer menu entries.
The Earthfile skips dracut regeneration for FIPS builds, so the USB media driver config must be added in the ubuntu-fips Dockerfiles where kairos-init regenerates the initramfs (-s init --fips). Add a 99-usb-media.conf (xhci_pci_renesas via add_drivers + force_drivers) to each Ubuntu FIPS version (20.04/22.04/24.04) and COPY it into /etc/dracut.conf.d/ before the kairos-init init step that runs dracut.
vipsharm
approved these changes
Jul 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Enables the Palette Edge installer to boot and install from USB media on hardware that uses a Renesas xHCI (USB 3.0) host controller.
Non-FIPS path
Earthfile— In thebase-imagetarget, write/etc/dracut.conf.d/99-usb-media.confwith:dracut -fregeneration (Ubuntu ~L788, openSUSE ~L820) soxhci_pci_renesasis actually bundled into the generated initramfs.build-isorepacks the existing/boot/initrd, so the config must exist before that regeneration to take effect.overlay/files-iso/boot/grub2/grub.cfg— Addpci=realloc=offto the installer menu entries to avoid PCI resource reallocation issues on affected hardware.FIPS path
The Earthfile skips dracut regeneration for FIPS builds (the FIPS base image builds its own initramfs). So the same driver config is added in the
ubuntu-fipsDockerfiles, wherekairos-init -s init --fipsregenerates the initramfs:ubuntu-fips/{20.04,22.04,24.04}/99-usb-media.conf(same three lines as above).COPYit into/etc/dracut.conf.d/99-usb-media.confbefore thekairos-init -s initstep in each FIPS Dockerfile.Notes
printf(Earthfile) / a static.conffile (FIPS) rather than a heredoc: Earthly'sRUNlexer (VERSION 0.6) does not support shell heredocs and errors on the heredoc body. Verified withearthly ls.add_drivers+force_driversguarantee the driver is included regardless of dracut hostonly mode.Testing
earthly ls ./parses the Earthfile without errors.99-usb-media.confcontent matches the intended dracut config.