Common issues and how to fix them.
If MongoDB fails to start, try these steps:
# Linux/Mac: Check if port 27017 is in use
sudo lsof -i :27017
# Windows: Check MongoDB service
sc query MongoDB
# Try restarting the service
sudo systemctl restart mongod
Make sure your media folders have the correct permissions:
# Linux: Fix ownership
sudo chown -R $USER:$USER /media/library
# Or add read permissions
sudo chmod -R 755 /media/library
If port 8001 is already in use:
# Find what's using the port
# Linux/Mac:
lsof -i :8001
# Windows:
netstat -ano | findstr :8001
# Kill the process or change the port in settings
Install FFmpeg for transcoding support:
# Ubuntu/Debian
sudo apt install ffmpeg
# macOS
brew install ffmpeg
# Windows - download from ffmpeg.org
# or use: choco install ffmpeg
Check these common causes:
1. Check browser console for errors (F12)
2. Try a different browser
3. Check if FFmpeg is installed
4. Verify file permissions
5. Try direct play vs transcoding
Improve streaming performance:
• Lower transcoding quality in settings
• Enable hardware transcoding (Intel QSV, NVIDIA)
• Use a wired connection instead of WiFi
• Check if server CPU is maxed out
• Try direct play if client supports the format
Troubleshoot subtitle issues:
• Check if subtitle file exists (.srt, .vtt)
• Verify subtitle encoding (UTF-8 recommended)
• Try burning subtitles into video
• Check subtitle settings in player
• Manually select subtitle track
Configure Gelatin for remote access:
1. Enable Gelatin in Settings > External Access
2. Create a new tunnel
3. No port forwarding needed!
4. Access via your custom domain
5. Check Cloudflare status if issues persist
Check the built-in engine:
• Verify DHT/PEX is enabled in settings
• Check if port is blocked by firewall
• Try different indexers
• Check torrent health (seeders)
• Review download queue in Activity
Test indexer connectivity:
1. Verify API key is correct
2. Test URL in browser
3. Check if Cloudflare protection is enabled
4. Try enabling "Cloudflare Protected" option
5. Check server logs for detailed errors
Improve search results:
• Add more indexers in Settings
• Check indexer is enabled
• Try different search terms
• Verify indexer categories match media type
• Some indexers require registration
Optimize download performance:
• Check your ISP isn't throttling
• Increase connection limits in settings
• Enable DHT, PEX, and LSD
• Try using a VPN
• Verify disk write speed isn't bottleneck