Skip to content
This repository was archived by the owner on Aug 7, 2025. It is now read-only.

Commit 68ae097

Browse files
ctalledorodnymolina
authored andcommitted
Added caveat regarding persistent mounts over a sys container's docker cache.
1 parent e812ca3 commit 68ae097

File tree

1 file changed

+15
-6
lines changed

1 file changed

+15
-6
lines changed

docs/quickstart.md

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -849,12 +849,21 @@ container can leverage an existing Docker image cache stored somewhere
849849
on the host, and thus avoid having to pull inner Docker images from
850850
the network each time a new system container is started.
851851

852-
A warning though: a persistent Docker image cache must only be mounted
853-
on a **single system container at any given time**. This is a
854-
restriction imposed by the Docker daemon, which does not allow its
855-
image cache to be shared concurrently among multiple daemon instances.
856-
Sysbox will check for violations of this rule and report an
857-
appropriate error during system container creation.
852+
There are a couple of caveats to keep in mind:
853+
854+
* A persistent Docker image cache must only be mounted on a **single
855+
system container at any given time**. This is a restriction imposed
856+
by the Docker daemon, which does not allow its image cache to be
857+
shared concurrently among multiple daemon instances. Sysbox will
858+
check for violations of this rule and report an appropriate error
859+
during system container creation.
860+
861+
* A persistent Docker image cache mounted into the system container's
862+
`/var/lib/docker` directory will "mask" any files present in that
863+
same directory as part of the system container's image. Such files
864+
would be present when using the system container build or commit
865+
features described [here](#building-a-system-container-that-includes-inner-container-images)
866+
and [here](#committing-a-system-container-that-includes-inner-container-images).
858867

859868
## Persistence of Inner Container Images with Bind Mounts
860869

0 commit comments

Comments
 (0)