From dea655ce95e7a6d066e9499b8da0808256706401 Mon Sep 17 00:00:00 2001 From: Thales Maciel Date: Thu, 30 Apr 2026 10:49:10 -0300 Subject: [PATCH] docs: fix paths from local to system install --- docs/oci-import-internals.md | 4 +++- docs/oci-import.md | 10 +++++++--- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/oci-import-internals.md b/docs/oci-import-internals.md index 434a01e..2607aa1 100644 --- a/docs/oci-import-internals.md +++ b/docs/oci-import-internals.md @@ -11,7 +11,9 @@ - **`Pull`** wraps `go-containerregistry`'s `remote.Image` with the `linux/amd64` platform pinned. Layer blobs cache under - `~/.cache/banger/oci/blobs/` and populate lazily during flatten. + `/var/cache/banger/oci/blobs/` (system install) or + `~/.cache/banger/oci/blobs/` (dev mode) and populate lazily during + flatten. - **`Flatten`** replays layers oldest-first into a staging directory, applies whiteouts, rejects unsafe paths plus filenames that banger's debugfs ownership fixup cannot encode safely. Returns a `Metadata` diff --git a/docs/oci-import.md b/docs/oci-import.md index 6160b7c..841aed7 100644 --- a/docs/oci-import.md +++ b/docs/oci-import.md @@ -90,12 +90,16 @@ Unknown distros fall back to `ID_LIKE`, then error cleanly. ## Paths +Paths below assume the system install (`banger system install`). When +running `bangerd` directly without the helper, the same files live +under `~/.cache/banger/` and `~/.local/state/banger/` instead. + | What | Where | |------|-------| -| Layer blob cache | `~/.cache/banger/oci/blobs/sha256/` | -| Staging dir | `~/.local/state/banger/images/.staging/` | +| Layer blob cache | `/var/cache/banger/oci/blobs/sha256/` | +| Staging dir | `/var/lib/banger/images/.staging/` | | Extraction scratch | `$TMPDIR/banger-pull-/` | -| Published image | `~/.local/state/banger/images//rootfs.ext4` | +| Published image | `/var/lib/banger/images//rootfs.ext4` | ## Cache lifecycle