# Deploy Posteria with Easypanel

URL: /templates/posteria

Posteria is a self-hosted, web-based media poster management system. It lets you organise and store custom artwork for your movies, TV shows, seasons, and collections. Posters can be uploaded from local files or URLs, pulled automatically from TMDB, TVDB, and Fanart.tv, or synced directly from your Plex server — with scheduled auto-imports and a full-screen poster wall for browsing your library.

## Installation notes

After deployment, open your service URL to reach the Posteria web UI.

## Benefits

### Centralised Poster Library

Keep all your movie, TV show, season, and collection artwork in one self-hosted location, accessible from any browser.

### Plex Integration

Sync posters directly from your Plex server and push custom artwork back with a single click or on an automated schedule.

### Multi-Source Artwork Import

Pull artwork automatically from TMDB, TVDB, and Fanart.tv so you always have the best available poster for every title.

## Features

### Poster Wall

Browse your entire poster collection in a full-screen, mobile- responsive wall view with fast fuzzy search.

### Upload from File or URL

Add posters by uploading local images (JPG, JPEG, PNG, WebP) or pasting a direct image URL.

### Scheduled Auto-Import

Configure a cron-style schedule to automatically pull new artwork from connected sources without manual intervention.

### Plex Poster Sync

Import the current poster from Plex for any item, or push a chosen poster back to update your Plex library artwork.

### Orphan Detection

Identify poster files that no longer match any media item in your library and clean them up in bulk.

### PWA Support

Install Posteria as a Progressive Web App on mobile or desktop for a native app-like experience.

## Configuration

- `appServiceName` (App Service Name, required): posteria

- `appServiceImage` (App Service Image, required): bozodev/posteria:1.7.5

- `authUsername` (Admin Username, required): admin

- `authPassword` (Admin Password): Set during installation — Leave empty to auto-generate it.

## Services

- posteria: app (bozodev/posteria:1.7.5)

## Resources

- [Website](https://posteria.app)

- [GitHub](https://github.com/jeremehancock/Posteria)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/posteria)