---
name: "desync-untar"
section: "1"
platform: "linux"
package: "desync"
version: "1.1.5-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/desync-untar"
---

# desync-untar(1)

Extract a directory tree from a catar archive or index

## NAME

desync-untar - Extract a directory tree from a catar archive or index

## SYNOPSIS

**desync untar \<catar\|index\> \<target\> \[flags\]**

## DESCRIPTION

Extracts a directory tree from a catar file or an index. Use '-' to read the index from STDIN.

The input is either a catar archive, or a caidx index file (with -i and -s).

By default, the catar archive is extracted to local disk. Using --output-format=gnu-tar, the output can be set to GNU tar, either an archive or STDOUT with '-'.

## OPTIONS

**--ca-cert**=""\
 	trust authorities in this file, instead of OS trust store

**-c**, **--cache**=""\
 	store to be used as cache

**-r**, **--cache-repair**\[=true\]\
 	replace invalid chunks in the cache from source

**--client-cert**=""\
 	path to client certificate for TLS authentication

**--client-key**=""\
 	path to client key for TLS authentication

**-n**, **--concurrency**=10\
 	number of concurrent goroutines, -1 to let desync choose: the number of CPUs for chunking and hashing, adapting to each store up to 128 for transfers

**-e**, **--error-retry**=3\
 	number of times to retry in case of network error

**-b**, **--error-retry-base-interval**=500ms\
 	initial retry delay, increases linearly with each subsequent attempt

**-h**, **--help**\[=false\]\
 	help for untar

**-i**, **--index**\[=false\]\
 	read index file (caidx), not catar

**--no-same-owner**\[=false\]\
 	extract files as current user

**--no-same-permissions**\[=false\]\
 	use current user's umask instead of what is in the archive

**--no-same-xattrs**\[=false\]\
 	don't apply extended attributes from the archive

**--output-format**="disk"\
 	output format, 'disk' or 'gnu-tar'

**-s**, **--store**=\[\]\
 	source store(s), used with -i

**-t**, **--trust-insecure**\[=false\]\
 	trust invalid certificates

## OPTIONS INHERITED FROM PARENT COMMANDS

**--config**=""\
 	config file (default $HOME/.config/desync/config.json)

**--digest**="sha512-256"\
 	digest algorithm, sha512-256 or sha256

**--verbose**\[=false\]\
 	verbose mode

## EXAMPLE

```
  desync untar docs.catar /tmp/documents
  desync untar -s http://192.168.1.1/ -c /path/to/local -i docs.caidx /tmp/documents
```

## SEE ALSO

**[desync(1)](/desync/1.md)**

## HISTORY

20-Oct-2026 Auto generated by spf13/cobra