.nh
.TH "desync" "1" "Sep 2026" "desync" ""

.SH NAME
desync-tar - Store a directory tree in a catar archive or index


.SH SYNOPSIS
\fBdesync tar <catar|index> <source> [flags]\fP


.SH DESCRIPTION
Encodes a directory tree into a catar archive or alternatively an index file
with the archive chunked into a store. Use '-' to write the output,
catar or index to STDOUT.

.PP
If the desired output is an index file (caidx) rather than a catar,
the -i option can be provided as well as a store. Using -i is equivalent
to first using the tar command to create a catar, then the make
command to chunk it into a store and produce an index file. With -i,
less disk space is required as no intermediary catar is created. There
can however be a difference in performance depending on file size.

.PP
By default, input is read from local disk. Using --input-format=tar,
the input can be a tar file or a stream from STDIN with '-'.


.SH OPTIONS
\fB--ca-cert\fP=""
	trust authorities in this file, instead of OS trust store

.PP
\fB-r\fP, \fB--cache-repair\fP[=true]
	replace invalid chunks in the cache from source

.PP
\fB-m\fP, \fB--chunk-size\fP="16:64:256"
	min:avg:max chunk size in kb

.PP
\fB--client-cert\fP=""
	path to client certificate for TLS authentication

.PP
\fB--client-key\fP=""
	path to client key for TLS authentication

.PP
\fB-n\fP, \fB--concurrency\fP=10
	number of concurrent goroutines

.PP
\fB-e\fP, \fB--error-retry\fP=3
	number of times to retry in case of network error

.PP
\fB-b\fP, \fB--error-retry-base-interval\fP=500ms
	initial retry delay, increases linearly with each subsequent attempt

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for tar

.PP
\fB-i\fP, \fB--index\fP[=false]
	create index file (caidx), not catar

.PP
\fB--input-format\fP="disk"
	input format, 'disk' or 'tar'

.PP
\fB--no-time\fP[=false]
	set file timestamps to zero in the archive

.PP
\fB-x\fP, \fB--one-file-system\fP[=false]
	don't cross filesystem boundaries

.PP
\fB-s\fP, \fB--store\fP=""
	target store (used with -i)

.PP
\fB--tar-add-root\fP[=false]
	pretend that all tar elements have a common root directory

.PP
\fB-t\fP, \fB--trust-insecure\fP[=false]
	trust invalid certificates


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--config\fP=""
	config file (default $HOME/.config/desync/config.json)

.PP
\fB--digest\fP="sha512-256"
	digest algorithm, sha512-256 or sha256

.PP
\fB--verbose\fP[=false]
	verbose mode


.SH EXAMPLE
.EX
  desync tar documents.catar $HOME/Documents
  desync tar -i -s /path/to/local pics.caidx $HOME/Pictures
.EE


.SH SEE ALSO
\fBdesync(1)\fP


.SH HISTORY
5-Sep-2026 Auto generated by spf13/cobra