---
name: "ch-pull2dir"
section: "1"
platform: "linux"
package: "charliecloud-builders"
version: "0.21-1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/ch-pull2dir"
---

# ch-pull2dir(1)

Pull image from a Docker Hub and unpack into directory

## NAME

ch-pull2dir - Pull image from a Docker Hub and unpack into directory

## SYNOPSIS

```
$ ch-pull2dir IMAGE[:TAG] DIR
```

## DESCRIPTION

Pull Docker image named **IMAGE\[:TAG\]** from Docker Hub and extract it into a subdirectory of **DIR**. A temporary tarball is stored in **DIR**.

Sudo privileges are required to run the **docker pull** command.

This runs the following command sequence: **ch-pull2tar**, **ch-tar2dir**. See warning in the documentation for **ch-tar2dir**.

Additional arguments:

- **--help**

  print help and exit

- **--version**

  print version and exit

## EXAMPLES

```
$ ch-pull2dir alpine /var/tmp
Using default tag: latest
latest: Pulling from library/alpine
Digest: sha256:621c2f39f8133acb8e64023a94dbdf0d5ca81896102b9e57c0dc184cadaf5528
Status: Image is up to date for alpine:latest
-rw-r--r--. 1 charlie charlie 2.1M Oct  5 19:52 /var/tmp/alpine.tar.gz
creating new image /var/tmp/alpine
/var/tmp/alpine unpacked ok
removed '/var/tmp/alpine.tar.gz'
```

Same as above, except optional **TAG** is specified:

```
$ ch-pull2dir alpine:3.6 /var/tmp
3.6: Pulling from library/alpine
Digest: sha256:cc24af836d1377e092ecb4e8f0a4324c3b1aa2b5295c2239edcc7bbc86a9cbc6
Status: Image is up to date for alpine:3.6
-rw-r--r--. 1 charlie charlie 2.1M Oct  5 19:54 /var/tmp/alpine:3.6.tar.gz
creating new image /var/tmp/alpine:3.6
/var/tmp/alpine:3.6 unpacked ok
removed '/var/tmp/alpine:3.6.tar.gz'
```

## REPORTING BUGS

If Charliecloud was obtained from your Linux distribution, use your distribution’s bug reporting procedures.

Otherwise, report bugs to: \<*https://github.com/hpc/charliecloud/issues*\>

## SEE ALSO

[charliecloud(7)](/charliecloud/7.md)

Full documentation at: \<*https://hpc.github.io/charliecloud*\>

## COPYRIGHT

2014–2020, Triad National Security, LLC