Troubleshooting
Common issues with symptoms, root causes, and fixes.
Download stuck at 0% VPN
Download added but no progress, speed shows 0 B/s.
VPN tunnel dropped and kill switch blocked all traffic.
Check VPN status, restart Gluetun.
arr vpndocker restart gluetunNo torrent peers Downloads
Torrent downloads have 0 peers, upload works fine.
Port forwarding not configured or expired.
Enable port forwarding in VPN provider, update Transmission.
arr vpnVPN won't connect VPN
Gluetun container restarts repeatedly.
Invalid credentials or server maintenance.
Check .env VPN credentials, try different server.
docker logs gluetun --tail 50Missing usenet articles Downloads
SABnzbd shows "missing articles" errors.
Content no longer available on your provider's backbone due to incomplete retention.
Use multiple providers on different backbones.
docker logs sabnzbd --tail 50Files copied not hardlinked Downloads
Disk usage doubles after import.
Downloads and media on separate Docker mounts.
Use single mount -v /data:/data.
ls -liPermission denied on import
Radarr/Sonarr fails to move or hardlink files.
PUID/PGID mismatch between services.
Ensure all services use same PUID/PGID in .env.
id $USER"No compatible streams" in Jellyfin Media
Playback fails with transcoding error.
Hardware transcoding not enabled or no driver access.
Enable QSV/VAAPI in Jellyfin dashboard, pass /dev/dri.
ls /dev/driSubtitles out of sync Media
Subtitles appear several seconds early or late.
Subtitle provider timing doesn't match release.
Enable subsync in Bazarr settings for automatic correction.
Bazarr → Settings → Subtitles → Post-Processing