pyr0ball
dc768a8dbb
14-page documentation site covering installation, quick start, full config reference, Sonarr/Radarr/qBittorrent/Tdarr integrations, ffmpeg/HandBrake transcoder setup, SSH transcode workers, disc format reference, and troubleshooting. Stack: mkdocs-material 9.x (MIT), pinned <10 to avoid 2.0 licence wall.
142 lines
2.4 KiB
Markdown
142 lines
2.4 KiB
Markdown
# Troubleshooting
|
||
|
||
## Discarr won't start
|
||
|
||
**Check Node.js version:**
|
||
|
||
```bash
|
||
node --version # must be 18+
|
||
```
|
||
|
||
**Check for port conflict:**
|
||
|
||
```bash
|
||
ss -tlnp | grep 8603
|
||
# Change port with: PORT=8604 node server.js
|
||
```
|
||
|
||
**Check logs (if running as a service):**
|
||
|
||
```bash
|
||
journalctl -u discarr -f
|
||
```
|
||
|
||
---
|
||
|
||
## Scan returns no titles
|
||
|
||
**ffprobe not found:**
|
||
|
||
```bash
|
||
which ffprobe # must be in PATH
|
||
ffprobe -version
|
||
```
|
||
|
||
**Disc structure not recognised:**
|
||
|
||
- Ensure the path points to the directory containing `VIDEO_TS` or `BDMV`, not inside it
|
||
- For ISOs, pass the full path including the `.iso` extension
|
||
- Check read permissions: `ls -la /path/to/disc`
|
||
|
||
**Encrypted DVD:**
|
||
|
||
```bash
|
||
dpkg -l libdvd-pkg 2>/dev/null || rpm -q libdvdcss 2>/dev/null
|
||
# Reinstall if missing — see Installation guide
|
||
```
|
||
|
||
---
|
||
|
||
## Encode fails immediately
|
||
|
||
**ffmpeg not found:**
|
||
|
||
```bash
|
||
which ffmpeg && ffmpeg -version
|
||
```
|
||
|
||
**HandBrake preset not found:**
|
||
|
||
```bash
|
||
HandBrakeCLI --preset-list | grep "H.265"
|
||
```
|
||
|
||
Check `HANDBRAKE_PRESET` matches exactly (case-sensitive).
|
||
|
||
**Disk space:**
|
||
|
||
```bash
|
||
df -h /tmp ~/.local/share/discarr
|
||
# Full HEVC encodes need 50–100 GB of temp space for large discs
|
||
```
|
||
|
||
---
|
||
|
||
## Sonarr/Radarr not importing after encode
|
||
|
||
**Check hook scripts are executable:**
|
||
|
||
```bash
|
||
ls -la /opt/discarr/scripts/
|
||
chmod +x /opt/discarr/scripts/*.sh
|
||
```
|
||
|
||
**Test the hook manually:**
|
||
|
||
```bash
|
||
DISCARR_URL=http://127.0.0.1:8603 /opt/discarr/scripts/sonarr-notify.sh
|
||
```
|
||
|
||
**Check API key:**
|
||
|
||
```bash
|
||
curl -s "http://your-sonarr-host:8989/sonarr/api/v3/system/status" \
|
||
-H "X-Api-Key: your-api-key" | python3 -m json.tool | head -5
|
||
```
|
||
|
||
**Check Sonarr logs:**
|
||
|
||
Sonarr: **System → Logs** — look for connection errors from the Custom Script hook.
|
||
|
||
---
|
||
|
||
## SSH transcode not working
|
||
|
||
**Test SSH connection:**
|
||
|
||
```bash
|
||
ssh -i ~/.ssh/id_ed25519 user@remote-host echo "OK"
|
||
```
|
||
|
||
**Check ffmpeg on remote:**
|
||
|
||
```bash
|
||
ssh user@remote-host which ffmpeg
|
||
```
|
||
|
||
**Check disk space on remote:**
|
||
|
||
```bash
|
||
ssh user@remote-host df -h /media
|
||
```
|
||
|
||
---
|
||
|
||
## Jobs stuck in queue after restart
|
||
|
||
The queue file persists across restarts at `~/.local/share/discarr/pending-queue.json`.
|
||
|
||
To clear a stuck job:
|
||
|
||
```bash
|
||
# Edit the queue file and remove the stuck entry
|
||
$EDITOR ~/.local/share/discarr/pending-queue.json
|
||
systemctl restart discarr
|
||
```
|
||
|
||
Or clear the whole queue:
|
||
|
||
```bash
|
||
echo '[]' > ~/.local/share/discarr/pending-queue.json
|
||
systemctl restart discarr
|
||
```
|