Retrieve 2DFS Images from Docker

Use Docker to pull 2DFS images from an OCI+2DFS registry.

To retrieve a 2DFS image from a Docker registry, you can use the docker pull command. This command allows you to download images from a registry that supports the OCI+2DFS format.

Additionally, you can use a semantic tag in the form --<row from>.<col from>.<row to>.<col to> to define the partition of the image you want to pull.

Let’s say we pushed to our registry an OCI+2DFS image with 2 rows and 2 columns, like this:

Row/ColCol 0Col 1
Row 0file1.txtfile2.txt
Row 1file3.txtfile4.txt

If we want to pull the first element of the first row (file1.txt), we can use the following command:

docker pull <your-registry-host>:5000/test/myfirsttdfs:v1--0.0.0.0

To retrieve the entire image as OCI image, you can use the following command:

docker pull <your-registry-host>:5000/test/myfirsttdfs:v1--0.0.1.1

To retrieve all elements except for file3.txt, you can use the following command:

docker pull <your-registry-host>:5000/test/myfirsttdfs:v1--0.0.0.1--1.0.1.1

Last modified July 6, 2025: added getstarted and concepts (a94131f)