From 392cc79108c295b3cbbe87f33eb989e06fa9d19f Mon Sep 17 00:00:00 2001 From: Colin Walters Date: Fri, 13 Dec 2024 20:23:35 +0000 Subject: [PATCH] docs/images: Document composefs here too This needs to be called out way more strongly than it is now. For example a lot of our assumptions about being able to put content anywhere (i.e. outside of `/usr` which happens especially with containers) which rely on it. Signed-off-by: Colin Walters --- docs/src/bootc-images.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/src/bootc-images.md b/docs/src/bootc-images.md index 92cc2918f..cea8330fb 100644 --- a/docs/src/bootc-images.md +++ b/docs/src/bootc-images.md @@ -147,3 +147,18 @@ which few domains can access. References: - + +## composefs + +It is strongly recommended to enable the ostree composefs +backend (but not strictly required) for bootc. +Do so by ensuring you have this in your `/usr/lib/ostree/prepare-root.conf`: + +``` +[composefs] +enabled = yes +[sysroot] +readonly = true +``` + +More in [ostree-prepare-root](https://ostreedev.github.io/ostree/man/ostree-prepare-root.html).