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)