docs: Also mention the bootc container storage in /sysroot

Someone looking to understand how things work is probably interested in this notable detail. Signed-off-by: Colin Walters <[email protected]>
containers · Aug 2, 2024 · 9f88023 · 9f88023
1 parent 12828ea
commit 9f88023
Showing 1 changed file with 14 additions and 1 deletion.
diff --git a/docs/src/filesystem-sysroot.md b/docs/src/filesystem-sysroot.md
@@ -21,11 +21,24 @@ When booted, the physical root will be available at `/sysroot` as a
 read-only mount point and the logical root `/` will be a bind mount
 pointing to a deployment directory under `/sysroot/ostree`.  This is a
 key aspect of how `bootc upgrade` operates: it fetches the updated
-container image and writes new files to `/sysroot/ostree`.
+container image and writes the base image files (using OSTree storage
+to `/sysroot/ostree/repo`).
 
 Beyond that and debugging/introspection, there are few use cases for tooling to
 operate on the physical root.
 
+### bootc-owned container storage
+
+For [experimental-logically-bound-images.md](logically bound images),
+bootc maintains a dedicated [containers/storage](https://github.com/containers/storage)
+instance using the `overlay` backend (the same type of thing that backs `/var/lib/containers`).
+
+This storage is accessible via a `/usr/lib/bootc/storage` symbolic link which points into
+`/sysroot`. (Avoid directly referencing the `/sysroot` target)
+
+At the current time, this storage is *not* used for the base bootable image.
+This [unified storage issue](https://github.com/containers/bootc/issues/20) tracks unification.
+
 ## Expanding the root filesystem
 
 One notable use case that *does* need to operate on `/sysroot`