Add service configurations and documentation

- Update Jellyfin Docker Compose configuration
- Add qBittorrent manual setup documentation
This commit is contained in:
2025-09-12 18:53:58 +02:00
parent 3dfe146297
commit ee5f2a4c18
2 changed files with 126 additions and 5 deletions

View File

@@ -25,11 +25,11 @@ services:
- /opt/docker/jellyfin/cache:/cache - /opt/docker/jellyfin/cache:/cache
# Media folders (shared with Copyparty) # Media folders (shared with Copyparty)
- /home/hoborg/Music:/media/music:ro - /mnt/nas/music:/media/music:ro
- /home/hoborg/Videos:/media/videos:ro - /mnt/nas/videos:/media/videos:ro
- /home/hoborg/Pictures:/media/pictures:ro - /mnt/nas/pictures:/media/pictures:ro
- /home/hoborg/shared:/media/shared:ro - /mnt/nas/shared:/media/shared:ro
- /home/hoborg/private:/media/private:ro - /mnt/nas/private:/media/private:ro
# Additional media folders if they exist # Additional media folders if they exist
# - /home/hoborg/Movies:/media/movies:ro # - /home/hoborg/Movies:/media/movies:ro

121
docs/qbittorrent-setup.md Normal file
View File

@@ -0,0 +1,121 @@
# qBittorrent Manual Setup Guide
This guide provides step-by-step instructions for manually configuring qBittorrent through the web UI to work with the existing NAS directory structure.
## Prerequisites
- qBittorrent container running via Docker
- NAS directory structure set up at `/mnt/nas/torrent/`
- Nginx reverse proxy configured for `/qbt/` path
## Current NAS Structure
The following directory structure should already exist:
```
/mnt/nas/torrent/
├── watch/
│ ├── music/
│ ├── videos/
│ ├── documents/
│ └── private/
└── complete/
├── music/
├── videos/
├── documents/
└── private/
```
## Manual Configuration Steps
### 1. Access qBittorrent Web UI
1. Open your browser and navigate to: `https://ak-homelab.duckdns.org/qbt/`
2. Login with:
- **Username**: `admin`
- **Password**: Check Docker logs for temporary password:
```bash
docker logs qbittorrent 2>&1 | grep "temporary password"
```
3. **IMPORTANT**: Change the default password on first login
### 2. Configure Basic Settings
1. Go to **Tools → Options → Downloads**
2. Set **Default Torrent Management Mode**: `Automatic`
3. Set **Default Save Path**: `/downloads/complete`
4. Enable **Auto managed torrents**
5. Click **Apply**
### 3. Create Download Categories
Right-click in the main torrent area and select **Add category** for each:
| Category | Save Path |
|----------|-----------|
| `music` | `/downloads/complete/music` |
| `videos` | `/downloads/complete/videos` |
| `documents` | `/downloads/complete/documents` |
| `private` | `/downloads/complete/private` |
### 4. Set Up Watch Folders
1. Go to **Tools → Options → Downloads**
2. Navigate to **Monitored Folder** section
3. Click **Add** to create watch folders:
| Watch Folder Path | Category |
|------------------|----------|
| `/downloads/watch/music` | `music` |
| `/downloads/watch/videos` | `videos` |
| `/downloads/watch/documents` | `documents` |
| `/downloads/watch/private` | `private` |
### 5. Test Configuration
1. Download a test `.torrent` file
2. Drop it into `/mnt/nas/torrent/watch/music/`
3. Verify it appears in qBittorrent with the correct category
4. Confirm it downloads to `/mnt/nas/torrent/complete/music/`
### 6. Optional: Hardlink Organization
After confirming downloads work correctly, you can set up automatic hardlinking to organize files for Jellyfin access:
```bash
./scripts/organize-torrents.py
```
This creates hardlinks from completed torrents to appropriate media directories without duplicating files.
## Troubleshooting
### Common Issues
1. **Permission errors**: Ensure qBittorrent container has read/write access to mounted volumes
2. **Watch folders not working**: Check that the paths are correctly mapped in docker-compose.yml
3. **Categories not auto-assigning**: Verify watch folder paths match exactly
### Docker Volume Mapping
Ensure your `docker-compose.yml` includes these volume mappings:
```yaml
volumes:
- /mnt/nas/torrent:/downloads
- qbittorrent-config:/config
```
### Logs
Check container logs for issues:
```bash
docker logs qbittorrent
```
## Security Recommendations
1. Change default admin password immediately
2. Enable 2FA if available in your qBittorrent version
3. Consider using authentication bypass only for local network access
4. Regularly update the container image for security patches