Troubleshooting¶

Common issues and solutions for Deleterr.

Connection Issues¶

Plex Connection Failed¶

Symptoms: Failed to connect to Plex or Plex token invalid

Solutions:

1. Verify URL format: Include protocol and port

   plex:
     url: "http://192.168.1.100:32400"  # Not just "192.168.1.100"
   

2. Check token: Get a fresh token from Plex documentation

3. SSL issues: If using HTTPS with self-signed certificates:

   ssl_verify: false
   

4. Network access: Ensure Deleterr container can reach Plex

   docker exec deleterr curl -s http://plex:32400/identity
   

Tautulli Connection Failed¶

Symptoms: Failed to connect to Tautulli or API key invalid

Solutions:

1. Find API key: Tautulli > Settings > Web Interface > API Key

2. Test connection:

   curl "http://tautulli:8181/api/v2?apikey=YOUR_KEY&cmd=get_server_info"
   

3. Check API access: Ensure API is enabled in Tautulli settings

Radarr/Sonarr Connection Failed¶

Symptoms: Failed to connect to Radarr/Sonarr

Solutions:

1. Find API key: Settings > General > Security > API Key

2. Verify URL: Include /api/v3 is NOT needed - Deleterr handles this

3. Test connection:

   curl -H "X-Api-Key: YOUR_KEY" http://radarr:7878/api/v3/system/status
   

Library Issues¶

Library Not Found¶

Symptoms: Library 'Movies' not found in Plex

Solutions:

1. Check exact name: Library name must match exactly (case-sensitive)

   # List Plex libraries
   curl -H "X-Plex-Token: YOUR_TOKEN" \
     http://plex:32400/library/sections | grep title
   

2. Use Plex library name: Not the folder name or Radarr root folder name

No Items Found for Deletion¶

Symptoms: Run completes but finds no items

Solutions:

1. Check thresholds: Items must meet ALL criteria

   last_watched_threshold: 90   # Watched 90+ days ago
   added_at_threshold: 180      # Added 180+ days ago
   

2. Verify watch history: Ensure Tautulli has watch data

3. Check exclusions: Your exclusion rules might be too broad

4. Review watch_status:

   watch_status: "watched"     # Only delete watched items
   watch_status: "unwatched"   # Only delete unwatched items
   watch_status: "all"         # Delete regardless of watch status
   

Wrong Items Being Deleted¶

Symptoms: Items deleted that shouldn't be

Solutions:

1. Always start with dry_run:

   dry_run: true
   

2. Add exclusions: Protect important content

   exclude:
     plex_labels: ["favorite", "keep"]
     collections: ["Marvel Cinematic Universe"]
   

3. Check library mapping: Ensure Radarr/Sonarr instance matches the Plex library

Disk Threshold Issues¶

Threshold Not Working¶

Symptoms: Items deleted even when disk has space (or not deleted when low)

Solutions:

1. Verify path: Must be a path accessible inside the container

   disk_size_threshold:
     - path: "/data/media"      # Container path, not host path
       threshold: "500GB"
   

2. Check mount: Ensure the volume is mounted correctly

   docker exec deleterr df -h /data/media
   

3. Threshold format: Use quotes and valid units

   threshold: "500GB"   # Correct
   threshold: 500GB     # May cause issues
   threshold: "500"     # Assumes bytes
   

Notification Issues¶

See Notifications Troubleshooting for notification-specific issues.

Docker Issues¶

Container Exits Immediately¶

Symptoms: Container starts and stops immediately

Solutions:

1. Check logs:

   docker logs deleterr
   

2. Verify config file: Ensure settings.yaml exists and is valid

   docker run --rm -v ./config:/config deleterr \
     python -c "import yaml; yaml.safe_load(open('/config/settings.yaml'))"
   

3. Check scheduler: If using built-in scheduler, container should stay running

   scheduler:
     enabled: true
   

Permission Denied Errors¶

Symptoms: Permission denied when accessing config or logs

Solutions:

1. Check ownership: Container runs as UID 1000 by default

   sudo chown -R 1000:1000 ./config ./logs
   

2. Or use PUID/PGID:

   environment:
     - PUID=1000
     - PGID=1000
   

Config Changes Not Applied¶

Symptoms: Changes to settings.yaml don't take effect

Solutions:

1. Restart container:

   docker compose restart deleterr
   

2. Check file location: Config must be at /config/settings.yaml inside container

3. Validate YAML syntax: Use a YAML validator

Scheduler Issues¶

Scheduler Not Running¶

Symptoms: Using built-in scheduler but Deleterr only runs once

Solutions:

1. Enable scheduler:

   scheduler:
     enabled: true
     schedule: "weekly"
   

2. Check restart policy:

   services:
     deleterr:
       restart: unless-stopped  # Not "no"
   

3. View scheduler status:

   docker logs deleterr | grep -i schedul
   

Ofelia Not Triggering¶

Symptoms: Using Ofelia but Deleterr never runs

Solutions:

1. Check Ofelia logs:

   docker logs scheduler
   

2. Verify labels:

   labels:
     ofelia.job-run.deleterr.schedule: "@weekly"
     ofelia.job-run.deleterr.container: "deleterr"  # Must match container_name
   

3. Ensure Docker socket mounted:

   volumes:
     - /var/run/docker.sock:/var/run/docker.sock:ro
   

Getting Help¶

If you're still stuck:

1. Enable debug logging:

   environment:
     LOG_LEVEL: DEBUG
   

2. Check GitHub Issues: github.com/rfsbraz/deleterr/issues

3. Create a new issue with:

4. Deleterr version
5. Sanitized config (remove API keys/tokens)
6. Relevant log output
7. Steps to reproduce