USB Drive Status
Mount Point:
/mnt/media/
File System:
ext4
Total Space:
Checking...
Available Space:
Checking...
Mount Status:
Mounted
RECORDS
Live TV Recordings
Initial Setup Instructions
1 Verify USB Mount
First, ensure your USB drive is properly mounted on your system:
# Check if USB drive is mounted
df -h /mnt/media/
# List USB drive contents
ls -la /mnt/media/
# Check permissions
stat /mnt/media/RECORDS
2 Configure Environment Variables
The .env file has been configured with your USB paths:
USB_RECORDS_PATH=/mnt/media/RECORDS
USB_MOVIES_PATH=/mnt/media/MOVIES
USB_MUSIC_PATH=/mnt/media/MUSIC
USB_PHOTOS_PATH=/mnt/media/PHOTOS
3 Start Docker Services
Build and start the containers with USB mount support:
# Stop existing containers
docker-compose down
# Rebuild with new configuration
docker-compose build --no-cache
# Start all services
docker-compose up -d
# Verify services are running
docker-compose ps
4 Configure Jellyfin Libraries
Access Jellyfin at http://localhost:8096 and add these libraries:
Jellyfin Library Paths
| Library Type |
Container Path |
USB Folder |
| Movies |
/media/movies |
MOVIES/ |
| Music |
/media/music |
MUSIC/ |
| Photos |
/media/photos |
PHOTOS/ |
| Recorded TV |
/media/recordings |
RECORDS/ |
Network Access via Samba
Access your USB media from any device on your network using these paths:
Windows
\\localhost\records (Live TV Recordings)
\\localhost\movies (Movie Collection)
\\localhost\music (Music Library)
\\localhost\photos (Photo Gallery)
macOS / Linux
smb://localhost/records (Live TV Recordings)
smb://localhost/movies (Movie Collection)
smb://localhost/music (Music Library)
smb://localhost/photos (Photo Gallery)
Note: Samba shares are configured with read/write access.
You can map these as network drives for easier access.
Recording Live TV
Live TV streams will be automatically recorded to your USB drive:
Recording Settings
- Recording Path:
/mnt/media/RECORDS/
- File Format:
.mp4 (H.264/AAC)
- Auto-organize: Recordings sorted by date
- Retention: Manual deletion (no auto-cleanup)
Start Recording from IPTV Menu
# From the IPTV CLI menu:
1. Select "Streaming Infrastructure"
2. Choose "Start Restreaming"
3. Select channel to record
4. Recording saves to USB automatically
Access Recordings
- Via Jellyfin: Browse "Recorded TV" library
- Via Samba: Access
\\localhost\records
- Via Web: View Recordings
Troubleshooting
Common Issues and Solutions
Permission Denied Errors
# Fix permissions for recording folder
sudo chmod 777 /mnt/media/RECORDS
# Fix ownership
sudo chown -R $USER:$USER /mnt/media/
USB Drive Not Mounting
# Check USB device
lsblk
# Mount manually
sudo mount /dev/sdX1 /mnt/media
# Add to /etc/fstab for auto-mount
echo "UUID=your-uuid /mnt/media ext4 defaults 0 2" | sudo tee -a /etc/fstab
Jellyfin Not Seeing Media
- Restart Jellyfin container:
docker-compose restart jellyfin
- Rescan libraries in Jellyfin settings
- Check container volumes:
docker inspect iptv-jellyfin
Samba Connection Issues
# Test Samba connection
smbclient -L localhost -N
# Check Samba logs
docker logs iptv-samba
# Restart Samba container
docker-compose restart samba
