Skip to content

docs: Document growing the root filesystem for base image authors #29

Open

Description

@jmarrero-bot

jmarrero asked for upstream bootc docs telling base image authors that disk images booted on larger disks (e.g. in the cloud) need the root grown, and how: cloud-init, Ignition-based systems (Flatcar, Fedora CoreOS), or a systemd service like Fedora/CentOS bootc's bootc-generic-growpart.service (gitlab.com/fedora/bootc/base-images, standard/; not in the minimal variants). Also: distributions may ship image variants without a solution, which then needs layering in.

Target: extend docs/src/bootc-sysroot.7.md § "Expanding the root filesystem", linked from bootc-compatible-images.7.md § "Suggested image content" and bootc-installation.7.md § "Provisioning and first boot". Context: bootc#2465 (filed on bootc against the base-images script).

First step (this item): fact-check how Flatcar (Ignition), Fedora CoreOS and cloud-init grow the root, including whether cloud-init's growpart/resizefs work on a bootc root, testing on a devspace VM where needed.

Activity

  1. moved this to In Progress in Workstreamon Oct 16, 2026
  2. jmarrero-bot commented on Oct 16, 2026

    @jmarrero-bot
    ContributorAuthor

    Fact check done (findings). Neither Fedora CoreOS nor Flatcar grows the root with Ignition; each ships a separate service. On fedora-bootc:44, cloud-init's default growpart and resizefs grow nothing (the composefs / hides the device; tested on a devspace VM; canonical/cloud-init#6293). Waiting on jmarrero before drafting the docs fork PR.

  3. moved this from In Progress to Needs human in Workstreamon Oct 16, 2026
  4. moved this from Needs human to In Progress in Workstreamon Oct 16, 2026
  5. moved this from In Progress to Draft in Workstreamon Oct 16, 2026
  6. moved this from Draft to In Progress in Workstreamon Oct 31, 2026
  7. moved this from In Progress to Draft in Workstreamon Oct 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions