GitHub - 9001/copyparty: Portable file server with accelerated resumable uploads, dedup, WebDAV, SFTP, FTP, TFTP, zeroconf, media indexer, thumbnails++ all in one file

Source

Summary

Copyparty is a single-file, zero-config Python file server that supports nearly every file transfer protocol (HTTP, WebDAV, SFTP, FTP, TFTP, SMB) with resumable uploads, deduplication, media indexing, and thumbnails. It runs on virtually any device with Python installed, from NAS boxes to ancient hardware, and can be exposed to the internet instantly via Cloudflare tunnels.

Key Insight

  • Single-file deployment: the entire server ships as one self-extracting Python script (copyparty-sfx.py) - no build steps, no containers required, though Docker is also supported
  • Protocol coverage in one binary: HTTP(S), WebDAV (read-write), SFTP (~700 MiB/s), FTP/FTPS, TFTP, and SMB/CIFS - eliminates the need to run separate daemons for each protocol
  • Performance numbers: expects ~8 GiB/s download, ~1 GiB/s upload on defaults; SFTP tops out around 700 MiB/s
  • Resumable chunked uploads (up2k): no file size limit, works even through Cloudflare; browser-based with multithreaded hashing
  • File deduplication: symlink-based content dedup on upload, reducing storage waste
  • Built-in media features: audio player with equalizer and dynamic range compression, video thumbnails, spectrograms, image gallery, CBZ manga reader, markdown viewer with server-side variable expansion
  • Search and indexing: full-text file search, ID3/audio tag indexing, search by size/date/path
  • Cross-platform: runs on Windows, Linux, macOS, Android (Termux), iOS (a-Shell), FreeBSD, and even exotic architectures (arm32/64, ppc64le, s390x, RISC-V, SGI IRIX)
  • Package availability: Arch Linux (pacman), Homebrew, Nix/NixOS, PyPI, Docker
  • Instant internet exposure: built-in support for Cloudflare quick tunnels with one command
  • Unique features: “race the beam” (download files while they are still uploading), self-destructing uploads, OPDS feeds for e-readers, RSS feeds for folder monitoring, Prometheus metrics