Skip to main content

Troubleshooting

  • Make sure your Downloads location matches on all your applications!
  • Most issues can be resolved by ensuring the user and group Unpackerr runs as has Read and Write permissions to the path trying to be extracted.
  • Most Docker (and Unraid) issues can be resolved by ensuring your paths align between containers
  • Paths below are formatted /host:/container
  • Common Bad Path Examples that will not work:
    • Example 1.
      • Sonarr: /mnt/user/data:/data
      • Qbittorrent: /mnt/user/data/downloads:/data/downloads
      • Unpackerr: /mnt/user/data/:/downloads
    • Example 2.
      • Sonarr: /mnt/user/data:/data
      • Qbittorrent: /mnt/user/data/downloads:/downloads
      • Unpackerr: /mnt/user/data/:/downloads
    • Example 3.
      • Sonarr: /mnt/user/data:/data
      • Qbittorrent: /mnt/user/data/torrents:/data/torrents
      • Unpackerr: /mnt/user/data/torrents:/data
  • Common Good Path Examples that will work:
    • Example 1.
      • Sonarr: /mnt/user/data:/data
      • Qbittorrent: /mnt/user/data/downloads:/data/downloads
      • Unpackerr: /mnt/user/data/downloads:/data/downloads

If transfers are in an Error state they will not be extracted.

Permissions tend to mess things up too, so make sure the user Unpackerr runs as can read and write to your download location.

Folder watch never queues anything​

On Docker bind mounts and CIFS, inotify often never fires. v1 does not poll unless you set a per-folder interval (try 1s). The old global UN_FOLDERS_INTERVAL does nothing.

If extracts start while a download is still writing, set wait_extensions (.part, .crdownload) or raise start_delay. See Watch folders.

Log files​

If you set log_file, that path is where Unpackerr writes. The Windows tray install documents C:\ProgramData\unpackerr\logs\unpackerr.log when you configure it that way.

If log_file is unset:

  • Linux: /var/log/messages or /var/log/syslog (default syslog)
  • FreeBSD: /var/log/syslog (default syslog)
  • macOS and Windows GUI: ~/.unpackerr/unpackerr.log

Still having problems? Let us know or find help on Discord.