Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

bootc is read-only when run in a default container

Currently, running e.g. podman run <someimage> bootc upgrade will not work. There are a variety of reasons for this, such as the basic fact that by default a docker|podman run <image> doesn't know where to update itself; the image reference is not exposed into the target image (for security/operational reasons).

Supported operations

There are only two supported operations in a container environment today:

  • bootc status: This can reliably be used to detect whether the system is actually booted via bootc or not.
  • bootc container lint: See man/bootc-container-lint.md.

Testing bootc in a container

Eventually we would like to support having bootc run inside a container environment primarily for testing purposes. For this, please see the tracking issue.


The Linux Foundation® (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see Trademark Usage.