# PosterFlow

PosterFlow is a self-hosted poster management system that syncs and manages movie and TV show posters across Google Drive using rclone. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1986/posterflow

## Description

PosterFlow is a self-hosted poster management system that syncs and manages movie and TV show posters across Google Drive using rclone. Features include drive syncing from community preset sources (MM2K, CL2K, etc.), automatic poster renaming to match your Plex/Radarr/Sonarr library, border replacement, unmatched asset detection, direct Plex upload, a built-in scheduler, and real-time job progress via WebSockets. Includes a setup wizard on first launch to configure your media server and Google Drive credentials.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

68/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 18 days ago)
- Popular: 27 (22 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 88 (no serious findings, 2 minor, CI, tests)

## Links

- Docker Hub: https://hub.docker.com/r/dweagle/posterflow
- GitHub: https://github.com/dweagle/posterflow
- Unraid: https://ca.unraid.net/apps/posterflow-0jcxvne0c5vq2m?q=PosterFlow

## Common questions

### Which port should I expose for PosterFlow in Docker?

Use host port 8357 to access the main application. The provided compose example maps host port 8357 to container port 8000.

### What volume do I need to mount, and what should I back up?

Mount ./config:/config as the only required volume. It stores posterflow.db, rclone.conf, drives_cache.json, the default poster cache, logs, scripts, and IDarr data, so back this directory up.

### What do I configure on first launch?

A setup wizard runs on first launch to configure media server connections and Google Drive credentials.

### Is there an Unraid template for PosterFlow?

Yes, PosterFlow is available in Community Apps for Unraid OS and can be installed from your server.

### Where can I find help diagnosing failures?

The troubleshooting docs provide a symptom-to-cause-to-fix table, log substrings to grep in posterflow.log, log locations, and instructions for capturing a diagnostic bundle.

---
Source: Our Local Host (https://ourlocalhost.com/app/1986/posterflow), the self-hosted and open-source app directory.
