BOOTC-EX...GRESS-FD(7)

💅 NAME 💅

bootc-experimental-progress-fd — interactive progress with --progress-fd, bestie 🫶

---

✨ DESCRIPTION ✨

Okay so first thing, no cap: this is an experimental feature. Like, we're in our beta era. The tracking issue lives here if you wanna watch the drama unfold: ⟨https://github.com/bootc-dev/bootc/issues/1016⟩ 🎀

So boom — the bootc status tooling already lets a client discover the state of the system, right? Adorable. But when you're doing interactive changes, like bootc upgrade or bootc switch, you can actually monitor the status of downloads and other operations at a fine-grained level with --progress-fd. She's nosy and we love that for her 👑

The format of data output over --progress-fd is JSON Lines ⟨https://jsonlines.org⟩, which is literally just a series of JSON objects separated by newlines. And important detail: the intermediate JSON content is guaranteed not to contain a literal newline. So you can parse it without crying 😭

Wanna see the JSON schema describing this version? It's right here: progress-v0.schema.json ⟨https://bootc.dev/bootc/progress-v0.schema.json⟩. Slay.

---

Deploying a new image with either switch or upgrade is a three-stage production, and yes, it's giving main character energy:

1. pulling — this step downloads the image from the registry, offering per-layer and progress in each message 🌈
2. importing — this step imports the image into storage and consists of a single step
3. staging — this runs a variety of staging tasks. Currently, they are staging the image to disk, pulling bound images, and removing old images 👑

Not me reminding you: new stages or fields may be added at any time. The format is a moving target, so don't hardcode your whole personality around it 💀

---

A lil vibe check on timing, because the way these stages behave is so dependent on stuff:

• Importing and staging are affected by disk speed and the total image size.
• Pulling is affected by network speed and how many layers invalidate between pulls.

Therefore, a large image with a good caching strategy will have longer importing and staging times, and a small bespoke container image will have negligible importing and staging times. That's just the physics of it, fr fr 🦋

---

🌸 SEE ALSO 🌸

• bootc(8)
• bootc-docs(7)

---

🎀 VERSION 🎀

v1.17.1

---

And that's the whole page, bestie! This one's from the Miscellaneous Information Manual — BOOTC-EX...GRESS-FD(7) — rocking version v1.17.1, and yeah the header and footer both just say BOOTC-EX...GRESS-FD(7) because the manpage is obsessed with itself 💖 Go monitor some downloads, you icon. Periodt. 💅