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

# ch-builder2squash(1)

Flatten a builder image into a Charliecloud SquashFS file

## NAME

ch-builder2squash - Flatten a builder image into a Charliecloud SquashFS file

## SYNOPSIS

```
$ ch-builder2squash [-b BUILDER] IMAGE OUTDIR [ARGS ...]
```

## DESCRIPTION

Flattens the builder image tagged **IMAGE** into a SquashFS file in **OUTDIR**.

Wrapper for **ch-builder2tar --nocompress** and **ch-tar2sqfs**. Intermediate files and directories are removed.

Sudo privileges are required to run **docker export**.

Optional **ARGS** passed to **mksquashfs** unchanged.

Additional arguments:

- **--help**

  print help and exit

- **--version**

  print version and exit

## EXAMPLE

```
$ docker image list | fgrep debian
REPOSITORY   TAG       IMAGE ID       CREATED      SIZE
debian       stretch   2d337f242f07   3 weeks ago  101MB
$ ch-builder2squash debian /var/tmp
Parallel mksquashfs: Using 6 processors
Creating 4.0 filesystem on /var/tmp/debian.sqfs, block size 131072.
[...]
squashed /var/tmp/debian.sqfs OK
$ ls -lh /var/tmp/debian*
-rw-r--r-- 1 charlie charlie 41M Apr 23 14:37 debian.sqfs
```

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