@@ -849,12 +849,21 @@ container can leverage an existing Docker image cache stored somewhere
849
849
on the host, and thus avoid having to pull inner Docker images from
850
850
the network each time a new system container is started.
851
851
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 ) .
858
867
859
868
## Persistence of Inner Container Images with Bind Mounts
860
869
0 commit comments