From 3d607d2f80596605de6077f26036e9b2333f3f20 Mon Sep 17 00:00:00 2001 From: Arpad Krejczinger Date: Tue, 19 Aug 2025 22:05:44 +0200 Subject: [PATCH] Update services documentation with WebDAV and permissions details MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add comprehensive copyparty feature list and status - Document WebDAV client setup (X-plore, rclone) - Update permission structure with rwmd flags - Add troubleshooting references for WebDAV issues - Include working client configuration examples 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- docs/services.md | 48 +++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 41 insertions(+), 7 deletions(-) diff --git a/docs/services.md b/docs/services.md index d8a47b5..b9bd0ae 100644 --- a/docs/services.md +++ b/docs/services.md @@ -264,16 +264,27 @@ sudo pacman -S copyparty - **SSL**: Let's Encrypt certificates with automatic renewal **User Accounts:** -- **guest**: Standard user with read/write access to shared areas -- **hoborg**: Admin user with access to all areas including private folder +- **guest**: Standard user with read/write (`rw`) access to shared areas +- **hoborg**: Admin user with full access (`rwmd` - read/write/move/delete) to all areas including private folder + +**Features:** +- ✅ File upload/download via web interface +- ✅ WebDAV support for X-plore File Manager, rclone, etc. +- ✅ File deletion via WebDAV (requires `d` permission) +- ✅ Drag & drop upload in web interface +- ✅ Support for files with spaces/special characters +- ✅ Large file upload support (up to 10GB) +- ✅ Resume interrupted uploads +- ✅ File deduplication and integrity checking **Volume Structure:** ``` -/shared → /home/hoborg/shared (guest, hoborg: rw) -/documents → /home/hoborg/Documents (guest, hoborg: rw) -/music → /home/hoborg/Music (guest, hoborg: rw) -/videos → /home/hoborg/Videos (guest, hoborg: rw) -/private → /home/hoborg/private (hoborg only: rw) +/shared → /home/hoborg/shared (guest: rw, hoborg: rwmd) +/documents → /home/hoborg/Documents (hoborg: rwmd) +/music → /home/hoborg/Music (guest: rw, hoborg: rwmd) +/videos → /home/hoborg/Videos (guest: rw, hoborg: rwmd) +/pictures → /home/hoborg/Pictures (guest: rw, hoborg: rwmd) +/private → /home/hoborg/private (hoborg only: rwmd) ``` **Features Enabled:** @@ -311,6 +322,29 @@ sudo systemctl disable copyparty - **Systemd service**: `/home/hoborg/homelab/config/systemd/copyparty.service` - **Nginx integration**: Path `/files/` in homelab.conf +**WebDAV Client Setup:** + +*X-plore File Manager (Android):* +- Server: `ak-homelab.duckdns.org` +- Path: `/files/shared/` (or other folder paths) +- Protocol: HTTPS (port 443) +- Username: `hoborg` +- Password: [your password] + +*rclone configuration:* +```bash +rclone config create homelab-webdav webdav \ + url=https://ak-homelab.duckdns.org/files/ \ + vendor=other \ + user=hoborg \ + pass=$(rclone obscure "your_password") +``` + +**Troubleshooting:** +- For issues with files containing spaces, see [docs/troubleshooting/webdav-copyparty.md](troubleshooting/webdav-copyparty.md) +- Check nginx WebDAV configuration for URL encoding issues +- Verify copyparty permissions include `d` flag for delete operations + **Testing Confirmed:** - ✅ File uploads working (including video files) - ✅ WebDAV folder uploads from Android (X-plore File Manager)