selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
copyparty logo

Self-host copyparty

v1.20.26

Portable file server with resumable uploads and protocols

ReleaseOpen SourceMIT
Updatedlast month
LanguagePython
Setup difficultyModerate
ThemeDark mode
Stars
47 364
Ports
3922 (SFTP server), 3945 (SMB/CIFS server), 3990 (FTPS server (explicit TLS)), 69 (TFTP standard port (UDP)), 1900 (SSDP discovery (UDP))
Requires
Python
Docker
copyparty/ac
Install with Docker
copyparty browser file listing UIQR code for quick mobile accesscopyparty running on SGI O2 with IRIXUpload interface with progressAudio player with OS media controlscopyparty.exe running on Windows

What is copyparty?

copyparty turns almost any device into a file server with resumable uploads and downloads using any web browser. It supports multiple protocols including HTTP/HTTPS, WebDAV, SFTP, FTP/FTPS, TFTP, and SMB/CIFS. The web UI provides a file manager with cut/paste/rename/delete, media player with playlists and equalizer, image/video thumbnails, full-text and metadata search, zip/tar folder downloads, markdown viewer and editor, and RSS/OPDS feeds. It runs on Python 2 or 3 with optional dependencies for extra features. Installation options include a self-extracting single file (SFX), pip, Docker images (multiple editions), platform packages (Arch, Homebrew, Nix, etc.), and standalone Windows executables. The server offers per-volume, per-user permissions with fine-grained access control, file deduplication, event hooks, identity provider integration (OIDC/OAuth/LDAP/WebAuthn via Authelia, authentik, etc.), and Prometheus metrics.

copyparty alternatives

Should you self-host copyparty?

copyparty scores 82/100 on selfhost.directory (how scoring works) and ranks #1 of 90 in File Sharing. It has 47 364 GitHub stars, +373 in the last 30 days.

It shipped 19 stable releases in the past year. The latest, v1.20.26, came out on 14 October 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is PairDrop (74/100, 11 813 stars). copyparty scores higher overall. See copyparty vs PairDrop side by side.

Features

  • File Deduplication
  • FTP/FTPS server
  • Identity Provider Integration
  • Markdown viewer and editor
  • Media Player
  • Resumable Uploads
  • RSS and OPDS feeds
  • SFTP server
  • SMB/CIFS serverunsafe, slow, not recommended for WAN
  • TFTP server
  • WebDAV Server
  • Zip/tar folder downloads

copyparty README

How to install copyparty

Install copyparty with Docker

Environment variables
PRTY_CONFIG for config file path

docker run --rm -it -u 1000 -p 3923:3923 -v /mnt/nas:/w -v $PWD/cfgdir:/cfg copyparty/ac

Multiple editions available (min, im, ac, iv, dj); ac recommended

How to configure copyparty

  • --ftpEnable FTP server on specified port

    values: port number

  • --sftpEnable SFTP server on specified port

    values: port number

  • --tftpEnable TFTP server on specified port

    values: port number

  • --smbEnable SMB read-only server
  • --smbwEnable SMB read-write server

copyparty releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

I want to learn Python by reading copyparty source code?

The author suggests this is not a good idea with an ASCII art response.

Thumbnails broken with blank boxes or placeholders?

Reverse proxy may be stripping query parameters (?th=w) or caching incorrectly; check URL rewrite rules and disable privacy extensions.

iPhone photos/videos have broken thumbnails?

Docker image and bootable flashdrive cannot read HEIF/HEIC or H.265/HEVC due to legal reasons.

Thumbnails show colorful squares instead of images?

Install FFmpeg or Pillow for thumbnail generation.

Copyparty thinks I'm using HTTP even though URL is HTTPS?

Reverse proxy not sending X-Forwarded-Proto: https header.

Server says 'thank you for playing' when accessing?

You've been banned for malicious traffic; check real-ip configuration if behind reverse proxy.

Firefox shows SEC_ERROR_BAD_SIGNATURE and no 'Accept Risk' button?

Firefox certstore is corrupted; delete cert9.db in your Firefox profile folder.

Can copyparty download a file from a URL to my server?

Yes, using hooks like bin/hooks/wget.py.

How do I stop .hist folders from appearing everywhere?

Use --hist global-option or hist volflag to move the .hist folder elsewhere.

Can I link to a password-protected file with the password in the URL?

Yes, add ?pw=password to the URL (or ?pw=username:password if --usernames is enabled).

Can I block read-access to folders unless you know the exact file URL?

Yes, using the 'g' permission or Linux filesystem permissions (chmod 111).

What is a volume?

A mapping from a URL path to a folder on the server filesystem with permissions and options.

What is a volflag?

Per-volume configuration; many global-options can be set as volflags and vice versa.

More in File Sharing

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…