Add copyparty file server with full integration
- Configure copyparty file server with user authentication - Set up multi-volume structure (shared, documents, music, videos, private) - Create systemd service for automatic startup - Add Nginx reverse proxy integration on /cloud/ path - Update documentation with complete setup and management guide - Mark Gitea and file server tasks as completed in TODO 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
107
docs/services.md
107
docs/services.md
@@ -137,31 +137,110 @@ docker-compose pull && docker-compose up -d # Update
|
||||
**Setup Progress:**
|
||||
1. ✅ Gitea container running
|
||||
2. ✅ Nginx reverse proxy setup complete
|
||||
3. 📋 Router port forwarding (80, 443) - **Next**
|
||||
4. ⚠️ Gitea web configuration - **Partially complete, needs debugging**
|
||||
3. ✅ Router port forwarding (80, 443) - **COMPLETE - External access working**
|
||||
4. ✅ Gitea web configuration - **COMPLETE**
|
||||
- Initial setup wizard completed
|
||||
- Base URL configuration issue (extra space in config)
|
||||
- UI accessible but routing may be broken
|
||||
5. 📋 SSL certificate setup - **After router config**
|
||||
- Admin user account created
|
||||
- SSH access configured
|
||||
- Repository migration completed
|
||||
5. 📋 SSL certificate setup - **Next step**
|
||||
|
||||
**Current Access:**
|
||||
- ✅ Local UI working: http://192.168.0.100/gitea/
|
||||
- ❓ External access: Pending router port forwarding
|
||||
- ⚠️ Configuration debugging needed
|
||||
- ✅ External access: http://ak-homelab.duckdns.org/gitea/ - **WORKING (fast response)**
|
||||
- ✅ Git SSH access: ssh://git@ak-homelab.duckdns.org:2223 - **WORKING**
|
||||
|
||||
**Debug Tasks:**
|
||||
- Fix base URL in `/opt/docker/gitea/data/gitea/conf/app.ini`
|
||||
- Check ROOT_URL setting for extra spaces
|
||||
- Verify redirect behavior after fix
|
||||
**Completed Configuration:**
|
||||
- Router forwards: 80→80, 443→443, 2223→2223
|
||||
- Removed direct port 3000 forwarding
|
||||
- Homelab repository successfully migrated to Gitea
|
||||
- External access confirmed working from Windows PC
|
||||
|
||||
## Cloud Storage Solutions
|
||||
|
||||
### Service Options
|
||||
- **Copyparty**: Quite new self-hosted file storage solution, must investigate!
|
||||
- **Nextcloud**: Full-featured, extensive app ecosystem ✅ *Recommended*
|
||||
- **Copyparty**: Lightweight file server with resumable uploads, dedup, WebDAV ✅ **DEPLOYED**
|
||||
- **Nextcloud**: Full-featured, extensive app ecosystem
|
||||
- **ownCloud**: Original project, stable and mature
|
||||
- **Seafile**: Performance-focused file sync
|
||||
- **Syncthing**: Decentralized sync (no server needed)
|
||||
- **Syncthing**: Decentralized sync (no server needed) ✅ **INSTALLED**
|
||||
|
||||
### Copyparty Installation and Configuration
|
||||
|
||||
**Status:** ✅ **DEPLOYED AND WORKING** - File server with upload/download capabilities
|
||||
|
||||
**Installation:**
|
||||
```bash
|
||||
# Installed via Arch package
|
||||
sudo pacman -S copyparty
|
||||
|
||||
# Configuration file location
|
||||
/home/hoborg/.config/copyparty/copyparty.conf
|
||||
|
||||
# Systemd service location
|
||||
/etc/systemd/system/copyparty.service
|
||||
```
|
||||
|
||||
**Current Setup:**
|
||||
- **Local Access**: http://127.0.0.1:8082/cloud/
|
||||
- **External Access**: http://ak-homelab.duckdns.org/cloud/
|
||||
- **Port**: 8082 (behind Nginx reverse proxy on /cloud/ path)
|
||||
- **Service**: Managed by systemd, auto-starts on boot
|
||||
|
||||
**User Accounts:**
|
||||
- **guest**: Standard user with read/write access to shared areas
|
||||
- **hoborg**: Admin user with access to all areas including private folder
|
||||
|
||||
**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)
|
||||
```
|
||||
|
||||
**Features Enabled:**
|
||||
- User-changeable passwords (stored securely in encrypted database)
|
||||
- Upload deduplication (saves storage space)
|
||||
- File indexing and search (e2dsa)
|
||||
- Resumable uploads with up2k
|
||||
- File integrity verification
|
||||
- Thumbnail generation for images and videos
|
||||
|
||||
**Security:**
|
||||
- Authentication required for all access
|
||||
- Passwords stored in encrypted format: `/home/hoborg/.config/copyparty/passwords.json`
|
||||
- Admin-only private folder isolated from shared areas
|
||||
- Reverse proxy headers for proper client IP logging
|
||||
|
||||
**Service Management:**
|
||||
```bash
|
||||
# Check status
|
||||
sudo systemctl status copyparty
|
||||
|
||||
# View logs
|
||||
journalctl -fu copyparty
|
||||
|
||||
# Restart service
|
||||
sudo systemctl restart copyparty
|
||||
|
||||
# Enable/disable autostart
|
||||
sudo systemctl enable copyparty
|
||||
sudo systemctl disable copyparty
|
||||
```
|
||||
|
||||
**Configuration Files:**
|
||||
- **Main config**: `/home/hoborg/.config/copyparty/copyparty.conf`
|
||||
- **Systemd service**: `/home/hoborg/homelab/config/systemd/copyparty.service`
|
||||
- **Nginx integration**: Path `/cloud/` in homelab.conf
|
||||
|
||||
**Testing Confirmed:**
|
||||
- ✅ File uploads working (including video files)
|
||||
- ✅ User authentication and authorization
|
||||
- ✅ Private folder access restricted to admin
|
||||
- ✅ External access through reverse proxy
|
||||
- ✅ Service auto-starts on boot
|
||||
|
||||
### Nextcloud Installation
|
||||
```bash
|
||||
|
||||
Reference in New Issue
Block a user