desync(1) desync(1)

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

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

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 '-'.

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

-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

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

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

--verbose[=false] verbose mode

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

desync(1)

5-Sep-2026 Auto generated by spf13/cobra

Sep 2026 desync