Skip to content

Commit 2b61c24

Browse files
authored
Merge pull request #749 from cgwalters/doc-filesystem-more
docs: Also mention the bootc container storage in /sysroot
2 parents 12828ea + 9f88023 commit 2b61c24

File tree

1 file changed

+14
-1
lines changed

1 file changed

+14
-1
lines changed

docs/src/filesystem-sysroot.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,11 +21,24 @@ When booted, the physical root will be available at `/sysroot` as a
2121
read-only mount point and the logical root `/` will be a bind mount
2222
pointing to a deployment directory under `/sysroot/ostree`. This is a
2323
key aspect of how `bootc upgrade` operates: it fetches the updated
24-
container image and writes new files to `/sysroot/ostree`.
24+
container image and writes the base image files (using OSTree storage
25+
to `/sysroot/ostree/repo`).
2526

2627
Beyond that and debugging/introspection, there are few use cases for tooling to
2728
operate on the physical root.
2829

30+
### bootc-owned container storage
31+
32+
For [experimental-logically-bound-images.md](logically bound images),
33+
bootc maintains a dedicated [containers/storage](https://github.com/containers/storage)
34+
instance using the `overlay` backend (the same type of thing that backs `/var/lib/containers`).
35+
36+
This storage is accessible via a `/usr/lib/bootc/storage` symbolic link which points into
37+
`/sysroot`. (Avoid directly referencing the `/sysroot` target)
38+
39+
At the current time, this storage is *not* used for the base bootable image.
40+
This [unified storage issue](https://github.com/containers/bootc/issues/20) tracks unification.
41+
2942
## Expanding the root filesystem
3043

3144
One notable use case that *does* need to operate on `/sysroot`

0 commit comments

Comments
 (0)