Skip to content

[Question/Help] WARNING - 1 file(s) failed to move to array #232

Closed

Description

@Yusseiin

Hi everyone,
i have 1 file that is keeping triggering the warning that PlexCache is not able to move it back on the array, but if i check on the array the file already exist, in both .plexcached and not.
How should i handle this ? should i delete the .mkv or do something on the PlexCache Dashboard?

Image
08:37:45 - INFO - --- Moving Files ---
08:37:45 - DEBUG - Restore sibling map: no associated files found for 1 files being restored
08:37:45 - INFO - [RESTORE] Returning to array (1 episode, instant via .plexcached):
08:37:45 - INFO -   L'era glaciale 4 - Continenti alla deriva (2012)
08:37:45 - DEBUG - Keeping in cache (OnDeck/Watchlist for Unicorno): L'era glaciale 4 - Continenti alla deriva (2012) [IT+EN] [Bluray-1080p x265] [DTS 5.1].mkv
08:37:45 - WARNING - 1 file(s) failed to move to array — exclude entries preserved for retry
08:37:45 - DEBUG - Files being passed to cache move: []
08:37:45 - INFO - [QUOTA] Min free space: 5% of 1885.38GB = 94.27GB
08:37:45 - INFO - [QUOTA] Cache drive usage: 1074.54GB (free: 807.65GB)
08:37:45 - DEBUG - Updating Unraid mover exclusions...
08:37:45 - DEBUG - Unraid mover exclusions updated.
08:37:45 - SUMMARY - There were no files to move to any destination.
08:37:45 - INFO - 
08:37:45 - INFO - --- Results ---
08:37:45 - INFO - [RESULTS] Already cached: 22 files
08:37:45 - INFO - [RESULTS] Moved to cache: 0 files
08:37:45 - INFO - [RESULTS] Moved to array: 1 files
08:37:45 - INFO - 
08:37:45 - INFO - [RESULTS] Completed in 29 seconds
08:37:45 - INFO - =================

Activity

  1. Brandon-Haney commented on Oct 19, 2026

    @Brandon-Haney
    Collaborator

    Nothing is actually failing here, and you don't need to delete anything. Please don't delete that .mkv. If you're looking through /mnt/user, that's the cached copy (the user share shows cached files at their original path). The .plexcached file is the real array backup.

    What the log shows is two parts of the run disagreeing. One step decided the movie was no longer needed and queued it to go back to the array. The next step saw it's still on Unicorno's OnDeck or Watchlist and kept it on the cache, which is the right call. The warning just counts that kept file as a failure, so you'll keep seeing it every run until Unicorno finishes the movie or it drops off their list. I'll fix the warning on our side.

    To find out why the first step thinks it's no longer needed, could you check a couple of things?

    • Is this movie pinned? Pinning is a newer feature: under Settings → Cache → Pinned Media you can search for a movie or show and pin it (Recently Added has pin buttons too), and PlexCache keeps it on the cache regardless of OnDeck or Watchlist. The list there shows anything currently pinned. If you've never used it, the answer is no.
    • Do you have OnDeck or Watchlist retention set under Settings → Cache?
    • Could you run once with verbose logging and paste any lines that mention this title, especially ones starting with "Movie still needed" or "Media no longer needed"? The debug log would help a lot in pinning down the mismatch.
  2. Yusseiin commented on Oct 20, 2026

    @Yusseiin
    Author

    Thanks Brandon.
    So is not pinned

    Image I have the retention Image

    for the verbose log i have
    One that says that file retention period is expired but another in days that is not could be this the problem ?

    10:01:52 - DEBUG - Converted path using 'Movies (2)': /data/Film/2012/L'era glaciale 4 - Continenti alla deriva (2012) [IT+EN] [Bluray-1080p x265] [DTS 5.1].mkv -> /mnt/user/media/Film/2012/L'era glaciale 4 - Continenti alla deriva (2012) [IT+EN] [Bluray-1080p x265] [DTS 5.1].mkv
    10:01:52 - DEBUG - OnDeck retention: L'era glaciale 4 - Continenti alla deriva (2012) [IT+EN] [Bluray-1080p x265] [DTS 5.1].mkv kept alive by Unicorno (11.5 days <= 14.0 days)
    10:02:26 - DEBUG - Path already in real format, skipping: /mnt/user/media/Film/2012/L'era glaciale 4 - Continenti alla deriva (2012) [IT+EN] [Bluray-1080p x265] [DTS 5.1].mkv
    10:02:26 - DEBUG - Timestamp already exists for: /mnt/cache/media/Film/2012/L'era glaciale 4 - Continenti alla deriva (2012) [IT+EN] [Bluray-1080p x265] [DTS 5.1].mkv
    10:02:26 - DEBUG - Marked OnDeck entry as cached: L'era glaciale 4 - Continenti alla deriva (2012) [IT+EN] [Bluray-1080p x265] [DTS 5.1].mkv (source=pre-existing)
    10:02:26 - DEBUG - File already on cache, added to exclude list: L'era glaciale 4 - Continenti alla deriva (2012) [IT+EN] [Bluray-1080p x265] [DTS 5.1].mkv
    10:02:26 - DEBUG - File retention period expired (276.0h >= 16h): /mnt/cache/media/Film/2012/L'era glaciale 4 - Continenti alla deriva (2012) [IT+EN] [Bluray-1080p x265] [DTS 5.1].mkv
    10:02:26 - DEBUG - Media no longer needed, will move back to array: L'era glaciale 4 - Continenti alla deriva (2012) - /mnt/cache/media/Film/2012/L'era glaciale 4 - Continenti alla deriva (2012) [IT+EN] [Bluray-1080p x265] [DTS 5.1].mkv
    10:02:26 - INFO - --- Moving Files ---
    10:02:26 - DEBUG - Restore sibling map: no associated files found for 1 files being restored
    10:02:26 - INFO - [RESTORE] Returning to array (1 episode, instant via .plexcached):
    10:02:26 - INFO -   L'era glaciale 4 - Continenti alla deriva (2012)
    10:02:26 - DEBUG - Keeping in cache (OnDeck/Watchlist for Unicorno): L'era glaciale 4 - Continenti alla deriva (2012) [IT+EN] [Bluray-1080p x265] [DTS 5.1].mkv
    10:02:26 - WARNING - 1 file(s) failed to move to array — exclude entries preserved for retry
    10:02:26 - DEBUG - Files being passed to cache move: []
    
  3. Brandon-Haney commented on Oct 20, 2026

    @Brandon-Haney
    Collaborator

    Thanks, that log pins it down. The two retention lines aren't the issue. The 16h one is just the minimum time a file stays on the cache, and once that passes it stops holding the file. The OnDeck line is the one that matters, and it's correctly keeping the movie for Unicorno.

    The actual cause is the year folders (Film/2012/...). When PlexCache decides what to move back, it falls back to guessing from the folder names for this file, and it reads a numbers-only folder like 2012 as a TV season. So it ends up thinking this is "Film, season 2012" and decides it's no longer needed. The next step checks the actual OnDeck list, sees Unicorno still has it, and keeps it. That's why you get the warning every run with nothing actually wrong.

    The same mix-up can also work the other way: other movies in year folders might be kept on the cache after they've been watched, as long as some other movie in those folders is still on someone's OnDeck or Watchlist. Nothing gets lost either way, it's just making the wrong keep/move decision.

    I'll fix the lookup so it uses Plex's own info for the file rather than guessing from folder names, and fix the warning. I'll post here when it's ready to try. No need to change your folder layout.

  4. Yusseiin commented on Oct 21, 2026

    @Yusseiin
    Author

    3. Thanks, that log pins it down. The two retention lines aren't the issue. The 16h one is just the minimum time a file stays on the cache, and once that passes it stops holding the file. The OnDeck line is the one that matters, and it's correctly keeping the movie for Unicorno.
    The actual cause is the year folders (Film/2012/...). When PlexCache decides what to move back, it falls back to guessing from the folder names for this file, and it reads a numbers-only folder like 2012 as a TV season. So it ends up thinking this is "Film, season 2012" and decides it's no longer needed. The next step checks the actual OnDeck list, sees Unicorno still has it, and keeps it. That's why you get the warning every run with nothing actually wrong.
    The same mix-up can also work the other way: other movies in year folders might be kept on the cache after they've been watched, as long as some other movie in those folders is still on someone's OnDeck or Watchlist. Nothing gets lost either way, it's just making the wrong keep/move decision.
    I'll fix the lookup so it uses Plex's own info for the file rather than guessing from folder names, and fix the warning. I'll post here when it's ready to try. No need to change your folder layout.

    Thanks a lot, i will wait for the fix :)

  5. Brandon-Haney commented on Oct 22, 2026

    @Brandon-Haney
    Collaborator

    The fix is merged (#233). It'll be in the :dev image once the current build finishes, or in the next release if you'd rather wait for that. Once you're on it, the "failed to move to array" warning for L'era glaciale 4 should stop, and any watched movies in your year folders that were being held on cache should go back to the array on the next run. Let me know how it goes.

  6. Yusseiin commented on Oct 22, 2026

    @Yusseiin
    Author

    Thanks, i will wait for the :dev image to be finished and test it right away.

    Edit. Tested the :dev
    L'era glaciale now is not "moved anymore" seems is not watching the "hours" but the days i have this line only
    07:41:11 - DEBUG - OnDeck retention: L'era glaciale 4 - Continenti alla deriva (2012) [IT+EN] [Bluray-1080p x265] [DTS 5.1].mkv kept alive by Unicorno (13.4 days <= 14.0 days)
    , but other films that where stuck moved without warning, but i am getting Could not resolve disk path
    Is this something related to a wrong config ? The file still moved in the end

    07:41:46 - INFO -   [Copying] Twilight 3 Eclipse (2010) AC3 5.1 ITA.ENG 2160p H265 HDR10 sub ita.eng Sp33dy94-MIRCrew.mkv (3.35 GB)
    07:41:46 - INFO -   [Copying] Una.Pallottola.Spuntata.2025.FULL.HD.1080p.Hevc.AC3.ITA.ENG.SUBS.TheEmojiCrew.mkv (2.55 GB)
    07:41:46 - DEBUG - Could not resolve disk path for: /mnt/user0/media/Film/2010/Twilight 3 Eclipse (2010) AC3 5.1 ITA.ENG 2160p H265 HDR10 sub ita.eng Sp33dy94-MIRCrew.mkv.plexcached
    07:41:46 - DEBUG - Could not resolve disk path for: /mnt/user0/media/Film/2025/Una.Pallottola.Spuntata.2025.FULL.HD.1080p.Hevc.AC3.ITA.ENG.SUBS.TheEmojiCrew.mkv.plexcached
    07:41:46 - DEBUG - Disk space check passed for unknown disk: need 100.00 MB, have 35.32 TB (rename)
    07:41:46 - DEBUG - Disk space check passed for unknown disk: need 100.00 MB, have 35.32 TB (rename)
    07:41:46 - DEBUG - Restored array file: /mnt/user0/media/Film/2010/Twilight 3 Eclipse (2010) AC3 5.1 ITA.ENG 2160p H265 HDR10 sub ita.eng Sp33dy94-MIRCrew.mkv.plexcached -> /mnt/user0/media/Film/2010/Twilight 3 Eclipse (2010) AC3 5.1 ITA.ENG 2160p H265 HDR10 sub ita.eng Sp33dy94-MIRCrew.mkv
    07:41:46 - DEBUG - Deleted cache file: /mnt/cache/media/Film/2010/Twilight 3 Eclipse (2010) AC3 5.1 ITA.ENG 2160p H265 HDR10 sub ita.eng Sp33dy94-MIRCrew.mkv
    07:41:46 - DEBUG - Removed cache timestamp for: /mnt/cache/media/Film/2010/Twilight 3 Eclipse (2010) AC3 5.1 ITA.ENG 2160p H265 HDR10 sub ita.eng Sp33dy94-MIRCrew.mkv
    07
    
  7. Brandon-Haney commented on Oct 26, 2026

    @Brandon-Haney
    Collaborator

    Glad it's working. Both of those are expected.

    The L'era glaciale line is the OnDeck Retention setting (Settings → Cache). You have it at 14 days, so once Unicorno's entry passes 14 days it'll go back to the array on the next run. If you want it shorter, lower that value.

    The "Could not resolve disk path" line is just debug noise. Before restoring, PlexCache tries to work out which physical disk (/mnt/disk1, /mnt/disk2...) the file is on so it can check free space there. The container doesn't have those mounted, so it falls back to checking through /mnt/user0, which is what the "unknown disk" line after it means. Nothing wrong with your config, and as you saw the file still moves fine.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions