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

.SH NAME
desync-index-server - Server for indexes over HTTP(S)


.SH SYNOPSIS
\fBdesync index-server [flags]\fP


.SH DESCRIPTION
Starts an HTTP index server that can be used as remote store. It supports
reading from a single local store or proxying to a remote store.
If --cert and --key are provided, the server will serve over HTTPS. The -w option
enables writing to this store.


.SH OPTIONS
\fB--authorization\fP=""
	expected value of the authorization header in requests

.PP
\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--cert\fP=""
	cert file in PEM format, requires --key

.PP
\fB--client-ca\fP=""
	acceptable client certificate or CA

.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 index-server

.PP
\fB--key\fP=""
	key file in PEM format, requires --cert

.PP
\fB-l\fP, \fB--listen\fP=[:http]
	listen address(es), can be repeated

.PP
\fB--log\fP=""
	request log file or - for STDOUT

.PP
\fB--mutual-tls\fP[=false]
	require valid client certificate

.PP
\fB-s\fP, \fB--store\fP=""
	upstream source index store

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

.PP
\fB-w\fP, \fB--writable\fP[=false]
	support writing


.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 index-server -s sftp://192.168.1.1/indexes -l :8080
  desync index-server -s /path/to/indexes -w -l :8080
.EE


.SH SEE ALSO
\fBdesync(1)\fP


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