desync(1)

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

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

HISTORY
6-Sep-2026 Auto generated by spf13/cobra