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

# ch-build2dir(1)

Build a Charliecloud image from Dockerfile and unpack it into a directory

## NAME

ch-build2dir - Build a Charliecloud image from Dockerfile and unpack it into a directory

## SYNOPSIS

```
$ ch-build2dir -t TAG [ARGS ...] CONTEXT OUTDIR
```

## DESCRIPTION

Build a Docker image named **TAG** described by a Dockerfile (default **$CONTEXT/Dockerfile**) and unpack it into **OUTDIR/TAG**. This is a wrapper for **ch-build**, **ch-builder2tar**, and **ch-tar2dir**; see also those man pages.

Arguments:

- **ARGS**

  additional arguments passed to **ch-build**

- **CONTEXT**

  Docker context directory

- **OUTDIR**

  directory in which to place image directory (named **TAG**) and temporary tarball

- **-t TAG**

  name (tag) of Docker image to build

- **--help**

  print help and exit

- **--version**

  print version and exit

## EXAMPLES

To build using **./Dockerfile** and create image directory **/var/tmp/foo**:

```
$ ch-build2dir -t foo . /var/tmp
```

Same as above, but build with a different Dockerfile:

```
$ ch-build2dir -t foo -f ./Dockerfile.foo . /var/tmp
```

## 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