Posteria

Self-hosted media poster management, honestly reviewed. Built for Plex users who are tired of their custom artwork getting wiped.

TL;DR

• What it is: A web-based poster management system (MIT) for Plex Media Server — upload, import, organize, and sync custom artwork for movies, TV shows, seasons, and collections [README].
• Who it’s for: Plex users who curate custom poster art and want a dedicated interface to manage it, rather than fighting Plex’s metadata refresh cycles that overwrite their selections [2][website].
• Cost: Free. Software is MIT-licensed, runs on any VPS or home server you already have. If you’re already running Plex, Posteria adds negligible overhead [README].
• Key strength: It locks posters in Plex after syncing, preventing metadata refreshes from overwriting your custom art. Auto-import runs on a schedule (hourly, every 3h, 6h, 12h, or 24h) [README][website].
• Key weakness: Plex-only. No Jellyfin or Emby support. Single developer, 197 GitHub stars — a young project still finding its footing [README][1].

---

What is Posteria

Posteria is a web app that sits alongside your Plex Media Server and solves a specific, narrow problem: keeping your poster artwork organized and protected. Anyone who has spent an hour curating custom movie posters in Plex knows the pain — a library refresh, a metadata agent update, and half your artwork reverts to Plex’s defaults. Posteria addresses this by acting as the authoritative source for your poster selections, syncing them back to Plex and locking them against overwrites [README][website].

The project launched in 2025 and was recognized in selfh.st’s annual roundup of self-hosted software launches [1]. It was built by a solo developer (GitHub handle: jeremehancock) and sits at 197 stars — a clear indication that this is a niche tool for a specific audience, not a general-purpose media application.

What it does: you upload or import posters (from local files, URLs, TMDB, TVDB, or Fanart.tv), organize them by category (Movies, TV Shows, TV Seasons, Collections), and sync them to Plex. When Posteria updates a poster in Plex, it locks that poster — Plex will no longer overwrite it during metadata refreshes [README][website]. There’s also an orphan detection feature that flags posters in Posteria that no longer correspond to anything in your Plex library, which is useful if you’ve removed content [website].

The developer’s own Reddit announcement put it plainly: “Posteria is a web-based media poster management system that allows you to organize and store custom posters for your movies, TV shows, seasons, and collections. It provides an elegant interface for uploading, importing, managing, and accessing your media artwork.” [2] A subsequent update added TMDB direct fetching, making it easier to import official artwork without leaving the interface [2].

---

Why people choose it

Third-party coverage is sparse — this is a 197-star project that launched in 2025 — so the clearest signal comes from the developer’s Reddit post and the community reaction to it [1][2].

The core problem Posteria solves is real and frequently discussed in r/selfhosted and Plex forums: metadata refreshes destroying custom poster selections. Plex’s native poster management works, but it’s a side feature of a media player, not a dedicated tool. If you maintain a large, carefully curated library with custom art for every item, the workflow is painful: Plex treats the last-known metadata source as authoritative, and automated library scans can silently reset artwork.

Posteria’s answer is to become the poster authority and enforce it. After syncing a poster, it locks the item in Plex so refreshes don’t touch the artwork [README][website]. The auto-import scheduler runs on a configurable interval (down to hourly) so any new Plex additions get folded into Posteria automatically [README].

The Reddit thread that announced the Plex Import feature drew positive responses from users who had been managing this manually or with scripts [2]. The fact that it pulls from TMDB, TVDB, and Fanart.tv in one interface — rather than requiring you to download images and upload them one by one — is cited as the practical time-saver.

It’s also available in the Unraid Community App Store, which reduces the setup friction for the large Unraid homelab community [README].

What it doesn’t offer is community testimonials, third-party benchmark comparisons, or independent long-term reviews. It’s new enough that the strongest endorsements are the developer’s own feature announcements and the organic Reddit upvotes. Take that for what it’s worth.

---

Features

Based on the README and official website:

Core poster management:

• Upload posters from local files or remote URLs [README]
• Fetch posters directly from TMDB (movies + TV), TVDB, and Fanart.tv [README]
• Import existing posters from Plex in one click [README][2]
• Sync updates back to Plex automatically; posters are locked in Plex after sync to prevent overwrites [README][website]
• Organize by category: Movies, TV Shows, TV Seasons, Collections [README]
• Fast fuzzy search across your poster library [README]
• Orphan poster detection — flags posters not linked to any current Plex library item [README][website]

Automation:

• Scheduled auto-import: 1h, 3h, 6h, 12h, or 24h intervals [README]
• Per-category import toggle: enable/disable auto-import independently for Movies, Shows, Seasons, Collections [README]
• Library exclusion: comma-separated list of Plex libraries to skip during import [README]
• Sort options: alphabetical or by recently added date from Plex [README]

Interface:

• Mobile-responsive design [README]
• Installable as a PWA for quick access on phones [README]
• Built-in Poster Wall — a visual showcase of your artwork [README]
• Simple username/password authentication with configurable session duration [README]
• Configurable images-per-page and max file size [README]

Format support: JPG, JPEG, PNG, WebP [README]

One important configuration flag to know about: AUTH_BYPASS=false — the README warns in bold to not use auth bypass if you expose Posteria outside your local network. The authentication is basic (username/password), not token-based or 2FA-capable. For a purely local-network deployment, this is fine. If you want to access it remotely, put it behind a VPN or a reverse proxy with additional auth [README].

Kometa compatibility: PLEX_REMOVE_OVERLAY_LABEL=false — setting this to true enables Kometa (formerly Plex Meta Manager) compatibility, which matters if you’re using both tools together [README].

---

Pricing: SaaS vs self-hosted math

There is no SaaS version of Posteria. It’s MIT-licensed software you run yourself. The cost model is simple:

• Software: $0 [README]
• Infrastructure: whatever you’re already spending on your home server or VPS

If you’re running Plex at home on a NAS or dedicated server, Posteria is essentially free — it’s a lightweight web app that runs alongside your existing stack. If you’re on a cloud VPS, add negligible compute (it’s a PHP/Docker container serving images, not a compute-heavy workload).

The indirect cost framing that makes more sense here: time. Manually managing custom posters in Plex — downloading images from TMDB, navigating to each library item, uploading, then watching them get reset by a metadata refresh — is the real cost Posteria replaces. No pricing math is needed, but the time savings scale with library size.

Note on Plex itself: Plex is free for basic use, but the API access that Posteria relies on (importing posters, syncing back, locking artwork) works with both free and Plex Pass accounts. Posteria doesn’t require Plex Pass, though some underlying Plex features may behave differently between account tiers. The PLEX_TOKEN environment variable handles authentication against your Plex server [README][website].

---

Deployment reality check

The install path is Docker Compose, which is the standard for this class of homelab tool. The README’s docker-compose.yml is complete and includes all environment variables with defaults and inline comments — it’s one of the better-documented single-file installs in this space [README].

What you need:

• Docker and docker-compose on any Linux machine (or NAS with Docker support)
• An existing Plex Media Server with a known URL and token
• Port 1818 exposed (or whatever you remap it to)
• Volume mounts for ./posters and ./data directories

Getting your Plex token: The website FAQ walks you through it — log into Plex Web, navigate to any media item, click “Get Info,” view the XML, and extract X-Plex-Token from the URL. It’s a few steps but documented [website].

What can go sideways:

The website FAQ contains a nuance worth quoting directly: “Posteria considers Plex to be the ‘source of truth’ for posters. So any changes to the posters in Plex directly or via another tool will override the posters in Posteria on the next import.” [website] This is the flip side of the locking feature — if you change a poster in Plex directly (not through Posteria), the next auto-import will pull Plex’s version into Posteria and overwrite your Posteria selection. The FAQ explicitly says Posteria is not a backup tool for this reason [website].

The auth bypass warning is the other thing to flag: AUTH_BYPASS=false should stay false if you’re not behind a VPN. Basic username/password is the only protection layer [README].

Realistic setup time: 15–30 minutes for anyone comfortable with Docker Compose. The environment variables are well-commented, and the FAQ covers the Plex token retrieval. If you’re new to Docker, budget 1–2 hours.

Unraid users get an additional path: it’s available in the Unraid Community App Store, which abstracts the Docker Compose configuration into a GUI template [README].

---

Pros and Cons

Pros

• Solves a real, specific problem. Plex’s poster management is a side feature. Posteria is purpose-built for it, with locking that prevents metadata refreshes from undoing your work [README][website].
• MIT license. Fork it, modify it, self-host it indefinitely without licensing concerns [README].
• Multi-source fetching. TMDB, TVDB, and Fanart.tv in one interface means you’re not manually downloading images [README].
• Scheduled auto-import. Set it once, and new Plex additions get imported on a cadence without manual intervention [README].
• Unraid Community App Store listing. For the large Unraid homelab userbase, this is a one-click install [README].
• PWA support. Installable on mobile for a native-app-like experience when managing posters from your phone [README].
• Lightweight. No heavy compute requirements — this is a poster management app, not a transcoding server.

Cons

• Plex-only. There’s no Jellyfin, Emby, or Kodi integration. If you run anything other than Plex, Posteria isn’t for you [README][website].
• Small project, single developer. 197 GitHub stars and no published forks visible means the bus factor is 1. Long-term maintenance depends on one person’s continued interest [README].
• Launched in 2025 — limited track record. Recognized in selfh.st’s new launches roundup [1] but not yet independently reviewed at depth by third parties.
• Basic authentication only. Username/password, no 2FA, no SSO. Fine for LAN-only use, requires a reverse proxy + VPN discipline for remote access [README].
• Plex is the source of truth, not Posteria. If you change a poster in Plex directly, the next auto-import overwrites Posteria’s copy. The tool works best if all poster changes flow through Posteria [website].
• No documented REST API. No programmatic access outside of the web interface.
• Not a backup tool. The FAQ explicitly warns against treating it as a poster backup, since it syncs from Plex, not to a separate archive [website].

---

Who should use this / who shouldn’t

Use Posteria if:

• You run Plex and maintain a curated library with custom poster art.
• Plex metadata refreshes have cost you hours of poster curation work.
• You’re already running Docker at home or on a VPS.
• You want to fetch and organize posters from TMDB/TVDB/Fanart.tv without bouncing between browser tabs.
• You’re on Unraid and want a one-click install from the Community App Store.

Skip it if:

• You use Jellyfin or Emby. Posteria is Plex-specific with no current plans for other backends.
• You don’t care about custom posters — Plex’s built-in picker is sufficient for most users.
• You want a backup solution. The FAQ is explicit: this is not a backup tool [website].
• You need more than basic authentication for remote exposure, and you’re not willing to run it behind a VPN or authenticated reverse proxy.
• You want a mature, well-supported tool with years of community usage behind it. This is a 2025-launched project maintained by one developer [1][README].

---

Alternatives worth considering

• Kometa (formerly Plex Meta Manager): The heavy-duty option. Kometa manages metadata, overlays, collections, and posters through YAML configuration files. Much more powerful, significantly steeper learning curve. Posteria even has a compatibility flag for running alongside it (PLEX_REMOVE_OVERLAY_LABEL) [README]. If you’re already running Kometa, you may not need Posteria.
• Mediux: A community-run poster sharing site (not self-hosted). People share custom poster sets; you download and upload to Plex manually. No automation, no syncing — pure manual workflow.
• Plex’s native poster management: Free, built-in, no extra infrastructure. Works well for moderate libraries where you don’t mind re-selecting posters after refreshes.
• Posterr: Another poster management project in the self-hosted space. Less documentation available at review time; community size is comparable to Posteria’s.

For a Plex user whose main pain point is custom artwork getting overwritten, the realistic comparison is Posteria vs. Kometa: Posteria for a focused, UI-driven poster tool; Kometa for full metadata management power at the cost of YAML configuration and a steeper ramp.

---

Bottom line

Posteria does one thing: it gives Plex users a dedicated interface to manage custom poster artwork, with automatic sync back to Plex and locking that prevents metadata refreshes from undoing your selections. If that sentence describes a problem you have, Posteria is the most purpose-built answer in the self-hosted space right now.

The caveats are real: it’s a 2025 project by a single developer at 197 GitHub stars, it’s Plex-only, and its authentication story is basic. None of that is a dealbreaker for the target user — someone running a home Plex server who wants their poster curation to stick. The MIT license and Docker Compose install mean setup takes under 30 minutes and costs nothing beyond your existing infrastructure.

If you’re an unsubbed.co reader already running a self-hosted media stack and spending time fighting Plex’s poster management, this is worth a 20-minute trial. If you want that setup handled for you, upready.dev deploys self-hosted stacks like this for clients — one-time fee, done, you own the infrastructure.

---

Sources

1. Ethan Sholly, selfh.st — “2025 Wrapped: Self-Hosted Software Launches” (January 1, 2026). https://selfh.st/post/wrapped-new-software-2025/
2. bozodev (developer), r/selfhosted — “Posteria (Now with Plex Import!)” (2025). https://www.reddit.com/r/selfhosted/comments/1iyf5cn/posteria_now_with_plex_import/

Primary sources:

• GitHub repository and README: https://github.com/jeremehancock/posteria (197 stars, MIT license)
• Official website: https://posteria.app