COPYPARTY - NEXUS DOCS WEB SHARING UI
System: CopyParty
Docker Image: copyparty/ac
Container: nexus-cdn
Public URL: https://docs.corlera.com
Purpose: Web-based file sharing, CDN storage, multi-protocol file server
What is CopyParty?
CopyParty is a lightweight file server (made in Norway, Python-based) that turns any device into a file sharing platform with: - Web browser uploads/downloads (resumable) - Multiple protocols: HTTP, WebDAV, FTP, TFTP, SMB/CIFS - Media player built into web UI - Thumbnail generation - Full-text and metadata search - Share link creation with passwords/expiration
Nexus Deployment
Docker Configuration
| Setting | Value |
|---|---|
| Image | copyparty/ac |
| Container | nexus-cdn |
| Port | 3923 (web interface) |
| User | 1000:1000 (nexus) |
| Timezone | America/Denver |
| Network | nexus-network |
Volume Mounts
/data/cdn:/w(read-write data storage)/data/cdn/system/config:/cfg(read-only config)
Environment
PRTY_UNSAFE_STATE=1(enables shares with read-only config)LD_PRELOAD=libmimalloc-secure.so.2(performance boost)
Web UI Features
File Management
- Drag-and-drop uploads (resumable)
- Cut/paste, rename, delete
- Folder creation
- Batch file operations
- Grid view with thumbnails
Sharing
- Create temporary share links
- Password protection
- Expiration times
- Upload permissions (allow others to upload)
Media
- Built-in audio player (almost all formats)
- Playlist support (M3U8)
- Audio equalizer
- Video playback
- Thumbnail generation for images/videos
Search
- Full-text search
- Search by size, date, path/name
- MP3 tag search (if indexed)
- File deduplication detection
Viewing
- Markdown viewer with two editors
- Text file viewer with live streaming (log tailing)
- OPDS feeds for e-book readers
- RSS feeds for folder monitoring
Protocols Supported
| Protocol | Port | Description |
|---|---|---|
| HTTP | 3923 | Primary web interface |
| WebDAV | 3923 | Read-write file access |
| FTP | - | Optional (--ftp flag) |
| TFTP | - | Optional (--tftp flag) |
| SMB/CIFS | - | Optional (not recommended WAN) |
Data Paths
Storage Root: /data/cdn/
User Folders:
/data/cdn/users/{username}/
├── documents/ # Private files
├── public/ # Anyone with link
├── shared/ # Password protected
├── images/ # Auto-categorized uploads
├── markdown/ # MD files
└── uploads/ # General uploads
URL Mapping: https://docs.corlera.com/home/{user}/{path} → /data/cdn/users/{user}/{path}
Integration with MCP
The mcp_docs_server.py wraps CopyParty to provide: - MCP tool interface for file operations - PDF generation (via WeasyPrint, not CopyParty) - Visibility-based folder routing - TEMP staging integration - Programmatic share link creation via CopyParty API
MCP Tools that use CopyParty:
- docs.upload → writes to /data/cdn/users/{user}/
- docs.create_share → calls CopyParty share API
- docs.get_url → generates docs.corlera.com URLs
- docs.list → reads from CopyParty storage
Security Features
- Per-folder, per-user permissions
- Account-based authentication
- IP-based authentication (CIDR)
- Password hashing support
- HTTPS support
- CORS configuration
- Filekeys (prevent filename bruteforcing)
- OAuth/identity provider integration
Archive Location
Source code and MCP server archived at:
/opt/mcp-servers/archive/docs-copyparty-legacy/
Contains: - mcp_docs_server.py (MCP wrapper) - copyparty/ (CopyParty source) - docker-compose.yml - Full documentation