luci-app-copyparty

OpenWrt procd service and LuCI interface for copyparty, a self-hosted file sharing server.

Requirements

• OpenWrt 23.05 or later (uses LuCI JavaScript views)
• python3 package installed
• copyparty single-file bundle (e.g. copyparty-en.py) downloaded separately from the copyparty releases page

Installation

# On the OpenWrt device:
sh install.sh

Or copy files manually to their destinations (see install.sh for the mapping).

The UCI config file (/etc/config/copyparty) is not overwritten if it already exists, so re-running install is safe.

Configuration

Edit /etc/config/copyparty:

config copyparty 'config'
    option enabled '1'
    option port '3923'
    option name 'MyNAS'
    option script '/path/to/copyparty-en.py'
    option usernames '0'      # set to 1 to require username+password

config volume
    option src '/mnt/raid/files'
    option dst '/files'
    option flags 'r'          # r=read, w=write, m=move, d=delete, g=get

config account
    option user 'alice'
    option pass 'secret'

Or configure via LuCI → Services → Copyparty.

Volume flags

Flag	Meaning
r	Read / browse (anonymous)
w	Write / upload
m	Move / rename
d	Delete
g	Download as file (bypasses browser preview)

Common combinations: r (read-only), rw (read/write), rwmd (full access).

See the copyparty docs for the full flag reference.

Service management

/etc/init.d/copyparty enable   # start on boot
/etc/init.d/copyparty start
/etc/init.d/copyparty stop
/etc/init.d/copyparty restart

File layout

etc/
  config/copyparty                          UCI config
  init.d/copyparty                          procd service script
usr/share/
  luci/menu.d/luci-app-copyparty.json       LuCI menu entry
  rpcd/acl.d/luci-app-copyparty.json        rpcd ACL
www/luci-static/resources/view/
  copyparty.js                              LuCI JavaScript view