BOOTC-IN-CONTAINER(7)

✨ BOOTC-IN-CONTAINER ✨

okay bestie, section 7 of the Miscellaneous Information Manual — this is the bootc-in-container page and it's basically a ✨vibe check✨ for running bootc inside a container. spoiler: it's giving read-only. 💅

---

🌸 NAME 🌸

bootc-in-container — bootc is read-only when you run it in a default container, no cap. 🫶

---

🦋 DESCRIPTION 🦋

So like. right now? running something like

podman run <someimage> bootc upgrade

is just not gonna work. 💀 not me finding out the hard way.

and there's a whole bunch of reasons, but the main one is honestly kind of obvious when you think about it: by default, a docker|podman run <image> has no idea where to update itself. like bestie, you didn't tell it where home is!! 🥺

the image reference just isn't exposed into the target image — and that's on purpose, for security and operational reasons. so it's not a bug, it's a boundary. periodt. 👑

---

✨ Supported operations ✨

there are literally only two supported operations in a container environment today, and I need you to respect them:

• bootc status — this one you can reliably use to detect whether the system is actually booted via bootc or not. it's the vibe detector fr fr 🔍✨
• bootc container lint — see man/bootc-container-lint.8.md (see bootc-container-lint(8)). go read that one, it's iconic.

🧚 Testing bootc in a container

eventually — and yes, eventually is doing a LOT of heavy lifting in that sentence 😭 — we would like to support having bootc run inside a container environment, primarily for testing purposes. so like, for the girlies who wanna test their stuff without committing to a whole system.

for that, please see the tracking issue: https://github.com/bootc-dev/bootc/issues/400 — go watch it, go star it, go be obsessed. 🌈⭐

---

👑 SEE ALSO 👑

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

---

💖 VERSION 💖

v1.17.1

---

⚠️ real talk: if you're in a default container, bootc is read-only. don't fight it, don't try to upgrade inside it — that's the whole point of this page. 💅

aaand that's the tea bestie 🍓 — this was page BOOTC-IN-CONTAINER(7) from the Miscellaneous Information Manual, sitting pretty at version v1.17.1. mwah, go slay ur containers responsibly 🎀💜