homescreen-hero

Overview

Plex companion app for users who want more control over how their libraries feel, not just how they're stored. It brings together collection management, automation, personalization, and server tools in one self-hosted app, all so that you get to choose what appears, when it appears, and who sees it. Wanna see it in action first? Check out the demo! https://demo.homescreenhero.com More info on features, installation, and general documenation can be found at https://docs.homescreenhero.com/

Runtime arguments

Web UI: http://[IP]:[PORT:8000]
Network: bridge
Shell: sh
Privileged: false

Template configuration

WebUI PortPorttcp

Port for accessing the web interface

Target: 8000
Default: 8000
Value: 8000

Data DirectoryPathrw

Directory for config.yaml, database, and logs

Target: /data
Default: /mnt/user/appdata/homescreen-hero
Value: /mnt/user/appdata/homescreen-hero

Plex TokenVariable

Your Plex authentication token (required - find at: https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/)

Target: HSH_PLEX_TOKEN

Plex URLVariable

Your Plex server URL (e.g., http://192.168.1.100:32400)

Target: HSH_PLEX_URL
Default: http://your-plex-url:32400

Auth PasswordVariable

Password for web UI authentication (optional but recommended)

Target: HSH_AUTH_PASSWORD

Auth Secret KeyVariable

JWT secret key for authentication (use website or generate with: openssl rand -hex 32)

Target: HSH_AUTH_SECRET_KEY

Trakt Client IDVariable

Trakt API client ID for third-party list integration (optional - get at: https://trakt.tv/oauth/applications)

Target: HSH_TRAKT_CLIENT_ID

MDBList API KeyVariable

MDBList API key for third-party list integration (optional - get at: https://mdblist.com/preferences/)

Target: HSH_MDBLIST_API_KEY

TMDB API KeyVariable

TMDB API key for third-party list integration (optional - get at: https://www.themoviedb.org/settings/api)

Target: HSH_TMDB_API_KEY

MAL Client IDVariable

MyAnimeList (MAL) Client ID for third-party list integration (optional - get at: https://myanimelist.net/apiconfig)

Target: HSH_MAL_CLIENT_ID

Tautulli URLVariable

URL of your selfhosted Tautulli instance (optional)

Target: HSH_TAUTULLI_BASE_URL

Tautulli API KeyVariable

Tautulli API key for dashboard analytics (optional)

Target: HSH_TAUTULLI_API_KEY

Seerr URLVariable

URL for your selfhosted Seerr (Jellyseerr/Overseerr) instance (optional)

Target: HSH_SEERR_BASE_URL

Seerr API KeyVariable

Seerr (Jellyseerr/Overseerr) API Key (optional)

Target: HSH_SEERR_API_KEY

Config File PathVariable

Path to config file (default is recommended)

Target: HOMESCREEN_HERO_CONFIG
Default: /data/config.yaml
Value: /data/config.yaml

Database PathVariable

Database path (default is recommended)

Target: HOMESCREEN_HERO_DB
Default: sqlite:////data/homescreen_hero.sqlite
Value: sqlite:////data/homescreen_hero.sqlite

Log DirectoryVariable

Directory for application logs (default is recommended)

Target: HOMESCREEN_HERO_LOG_DIR
Default: /data/logs
Value: /data/logs

Links

Template Support Docker Hub Project

Details

Repository

trentferguson/homescreen-hero:latest

Registry

https://hub.docker.com/r/trentferguson/homescreen-hero

Last Updated2026-04-08

First Seen2026-02-03

Run homescreen-hero on Unraid.

homescreen-hero is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS