Skip to content

Overlay "Run Now" crashes server with uncaught EPIPE during poster restore/revert #2780

@SmolSoftBoi

Description

@SmolSoftBoi

Describe the bug
Clicking Run Now from the Overlays page starts overlay processing, but the server crashes with an uncaught EPIPE error while reverting an item that is no longer in an overlay-enabled collection.

The crash appears to happen during the overlay revert/original poster restore process.

To Reproduce

  1. Go to Overlays
  2. Click Run Now
  3. Overlay processing starts
  4. Server crashes with write EPIPE

Expected behavior
Overlay processing should start immediately and complete without crashing.
If poster restoration fails, the backup should be kept for retry without causing an uncaught exception.

Actual behavior
The overlay processor starts, begins processing overlay-enabled collections, attempts to revert items no longer in overlay collections, then crashes with an uncaught EPIPE error.

Device / Environment

  • OS: Synology DSM
  • DSM Version: 7.3.2
  • Server: Plex
  • Deployment: Docker container
  • App/container: maintainerr

Debug logs

[maintainerr]  |  27/04/2026 00:01:28  [INFO] [OverlayProcessorService] === Overlay processor started ===
[maintainerr]  |  27/04/2026 00:01:28  [INFO] [OverlayProcessorService] Processing 4 overlay-enabled collection(s)
[maintainerr]  |  27/04/2026 00:01:28  [INFO] [OverlayProcessorService] Item 196718 no longer in any overlay collection, reverting
[maintainerr]  |  27/04/2026 00:01:28  [WARN] [OverlayProcessorService] Failed to restore original poster for 196718; keeping backup for retry
[maintainerr]  |  27/04/2026 00:01:28  [INFO] [OverlayProcessorService] Item 191163 no longer in any overlay collection, reverting
[maintainerr]  |  27/04/2026 00:01:28  [ERROR] [main] The server has crashed because of an uncaughtException. This is likely a bug, please report this issue on GitHub: write EPIPE | code=EPIPE
Error: write EPIPE
    at WriteWrap.onWriteComplete [as oncomplete] (node:internal/stream_base_commons:87:19)

Additional context
The issue may be related to restoring original Plex posters for items that have left overlay-enabled collections. The previous item logs a poster restore failure but continues; the following item starts reverting and then the server crashes with an uncaught EPIPE.

The crash is reproducible by manually triggering overlay processing via Run Now.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions