desync(1)

📦
version 1.1.5 · 3 versions
, in arch rolling

💖 desync(1): the desync-index-server glow-up 💖

💌 NAME 💌

desync-index-server — Server for indexes over HTTP(S). That's the whole vibe, bestie: it's the server for indexes over HTTP(S). 💅

🦋 SYNOPSIS 🦋

desync index-server [flags]

✨ DESCRIPTION ✨

Okay so it 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.

Translation for the group chat: local store? remote proxy? both are supported. HTTPS needs both --cert and --key. Writing needs -w. No cap. 🫶

💅 OPTIONS 💅

  • --authorization="" — expected value of the authorization header in requests. It's giving "header check, but make it exact." 🔥
  • --ca-cert="" — trust authorities in this file, instead of OS trust store. This file is the trust-authority plug. 🎀
  • -r, --cache-repair[=true] — replace invalid chunks in the cache from source. Cache looking a little messy? This is the repair button. 🧚
  • --cert="" — cert file in PEM format, requires --key. Bestie, it needs its key partner. 🔑
  • --client-ca="" — acceptable client certificate or CA. Client-certificate approval list energy. ✨
  • --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. Literally the multitasking setting. 🌀
  • -e, --error-retry=3 — number of times to retry in case of network error. Network said "no"? Try again, up to this many times. 😭
  • -b, --error-retry-base-interval=500ms — initial retry delay, increases linearly with each subsequent attempt. Retry delay starts here, then climbs. 📈
  • -h, --help[=false] — help for index-server. The classic "help me help you" flag. 💖
  • --key="" — key file in PEM format, requires --cert. Again: key needs cert, cert needs key. Iconic duo. 🤝
  • -l, --listen=[:http] — listen address(es), can be repeated. Stack those listen addresses like little server earrings. 🎀
  • --log="" — request log file or - for STDOUT. - means STDOUT, fr fr. 🖥️
  • --mutual-tls[=false] — require valid client certificate. Mutual TLS says "show me your client cert." 💀
  • -s, --store="" — upstream source index store. The source-store bestie. 📦
  • -t, --trust-insecure[=false] — trust invalid certificates. Yes, it says invalid, so be dramatic about it if you use it. 🚨
  • -w, --writable[=false] — support writing. Unlock write mode, bestie. ✍️

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

  • --config="" — config file (default $HOME/.config/desync/config.json). Your config home base. 🏠
  • --digest="sha512-256" — digest algorithm, sha512-256 or sha256. Pick your hashing flavor. 🧁
  • --verbose[=false] — verbose mode. For when you want the lore, not just the summary. 👀

🌸 EXAMPLE 🌸

desync index-server -s sftp://192.168.1.1/indexes -l :8080
desync index-server -s /path/to/indexes -w -l :8080

🫶 SEE ALSO 🫶

desync(1) — go say hi to the parent command, iykyk.

🎀 HISTORY 🎀

20-Oct-2026 Auto generated by spf13/cobra

💖 source/version: desync · date: Oct 2026 · manual: desync(1) — slay and goodbye 💖

📦 where this page comes from