🎬 Media Services — Companion Apps

Host: Homelab · Compose: Homelab/Media/services/compose.yaml
Stack name: services

[!NOTE] Update Available: Updates for this stack are pending in: renovate/docker-dependencies.

1. Overview

Media companion applications that supplement the main ARR-Stack: a book manager, media statistics tools, YouTube archiving, podcast management, music discovery (Soulseek), and more. These run on the media server alongside the main media library.

2. Architecture & Services

Service	Image	Port	Role
`bl_mariadb`	`lscr.io/linuxserver/mariadb:11.8.8`	—	MariaDB for Booklore
`booklore`	`ghcr.io/the-booklore/booklore:v2.2.2`	`6060`	eBook and comic book library manager
`jellyplex-watched`	`luigi311/jellyplex-watched:8.5.3`	—	Sync watched status Jellyfin ↔ Plex
`jellystat`	`cyfershepard/jellystat:1.1.12`	`3282`	Jellyfin statistics dashboard
`jellystat-db`	`postgres:15@sha256:9b1d34adbce1dd07ee6e94b4a2cf698884b89bd44a6c9c12f5da8f3acbfe4957`	—	PostgreSQL for Jellystat
`kids_pinchflat`	`ghcr.io/kieraneglin/pinchflat:latest@sha256:01b4f98aabaf3f5fe394213f7a32578c9e84e42080f52e2f8334021a4473b202`	`8946`	YouTube downloader (Kids content)
`koito`	`gabehf/koito:v0.3.2`	—	Anime watch list tracker
`opodsync`	`ganeshlab/opodsync:0.6.0-amd64`	`38081`	gPodder sync server
`pinchflat`	`ghcr.io/kieraneglin/pinchflat:latest@sha256:01b4f98aabaf3f5fe394213f7a32578c9e84e42080f52e2f8334021a4473b202`	`8945`	YouTube downloader (main)
`pinepods`	`madeofpendletonwool/pinepods:0.9.0`	`8040`	Self-hosted podcast manager
`pinepods_db`	`11notes/postgres:17@sha256:6860d92d13eabd73703220ebc9ee401c12922d4eb7715e70adf3b2041768a486`	—	PostgreSQL for Pinepods
`podgrab`	`akhilrex/podgrab:1.0.0`	`28081`	Podcast downloader
`soulseek`	`realies/soulseek:latest@sha256:884827d6ed9757a525a2ed8be28ba5a48c47ddaab3e80a6c4413b5a85611a4aa`	`6080`	Soulseek P2P music client (web UI)
`stash`	`stashapp/stash:v0.31.1`	`9999`	Adult media library manager
`tautulli`	`tautulli/tautulli:v2.18.1`	`8181`	Plex statistics and notifications
`valkey`	`valkey/valkey:8-alpine3.21`	—	Valkey cache for Pinepods
`ytvids-pinchflat`	`ghcr.io/kieraneglin/pinchflat:latest@sha256:01b4f98aabaf3f5fe394213f7a32578c9e84e42080f52e2f8334021a4473b202`	`8947`	YouTube downloader (YT Vids)

3. Networking

apps — External shared app network
cloudflare-net — External for Cloudflare Tunnel access (Booklore, Koito, gPodder)
database — External shared database network
traefik — External for Traefik routing

4. Persistent Storage

| Container | Host Path / Volume | Description | |---|---|---|| | bl_mariadb | /docker/data/media/booklore/mariadb/config | — | | booklore | /docker/data/media/booklore/bookdrop | — | | booklore | /docker/data/media/booklore/data | App data | | booklore | /nfs/media/booklore/ | Book files (NFS) | | jellystat | /docker/data/media/jellystat/jellystat | — | | jellystat-db | /docker/data/media/jellystat/postgres | DB data | | kids_pinchflat | /docker/data/media/kids-pinchflat/config | — | | kids_pinchflat | /nfs/media/Kids-YouTube | — | | koito | /docker/data/media/koito/data | — | | opodsync | /docker/data/media/gpodder | — | | pinchflat | /docker/data/media/pinchflat/config | Config + /nfs/media/YouTube | | pinchflat | /nfs/media/YouTube | — | | pinepods | /docker/data/media/pinepods/backups | — | | pinepods | /nfs/media/Podcasts/ | Podcast downloads | | pinepods_db | /backup/database/media/pinepods | — | | pinepods_db | pinepods.postgres.etc | — | | pinepods_db | pinepods.postgres.var | — | | podgrab | /docker/data/media/podgrab/assets | — | | podgrab | /docker/data/media/podgrab/config | — | | soulseek | /Downloads/soulseek | — | | soulseek | /docker/data/media/soulseek/appdata | App data | | soulseek | /docker/data/media/soulseek/logs | — | | soulseek | /docker/data/media/soulseek/shared | — | | soulseek | /nfs/media/Music | — | | stash | /docker/data/media/stash/config | — | | stash | /etc/localtime | — | | stash | /nfs/media/pr0n/blobs | — | | stash | /nfs/media/pr0n/cache | — | | stash | /nfs/media/pr0n/generated | — | | stash | /nfs/media/pr0n/metadata | — | | stash | /nfs/media/pr0n/videos | — | | tautulli | /docker/data/media/tautulli | Config and history | | ytvids-pinchflat | /docker/data/media/yt-pinchflat/config | — | | ytvids-pinchflat | /nfs/media/YouTubeVids | — |

5. Environment Variables

Variable	Service	Description
`MYSQL_DATABASE`	`bl_mariadb`	—
`MYSQL_PASSWORD`	`bl_mariadb`	—
`MYSQL_ROOT_PASSWORD`	`bl_mariadb`	—
`MYSQL_USER`	`bl_mariadb`	—
`PGID`	`bl_mariadb`	—
`PUID`	`bl_mariadb`	—
`TZ`	`bl_mariadb`	`Australia/Sydney`
`DATABASE_PASSWORD`	`booklore`	—
`DATABASE_URL`	`booklore`	—
`DATABASE_USERNAME`	`booklore`	—
`PGID`	`booklore`	—
`PUID`	`booklore`	—
`SWAGGER_ENABLED`	`booklore`	—
`TZ`	`booklore`	`Australia/Sydney`
`PGID`	`jellyplex-watched`	—
`PUID`	`jellyplex-watched`	—
`JWT_SECRET`	`jellystat`	—
`POSTGRES_IP`	`jellystat`	—
`POSTGRES_PASSWORD`	`jellystat`	—
`POSTGRES_PORT`	`jellystat`	—
`POSTGRES_USER`	`jellystat`	—
`TZ`	`jellystat`	`Australia/Sydney`
`POSTGRES_PASSWORD`	`jellystat-db`	—
`POSTGRES_USER`	`jellystat-db`	—
`TZ`	`kids_pinchflat`	`Australia/Sydney`
`KOITO_SQLITE_ENABLED`	`koito`	`true`
`TZ`	`pinchflat`	`Australia/Sydney`
`DB_HOST`	`pinepods`	—
`DB_NAME`	`pinepods`	—
`DB_PASSWORD`	`pinepods`	—
`DB_PORT`	`pinepods`	—
`DB_TYPE`	`pinepods`	`postgresql`
`DB_USER`	`pinepods`	—
`DEBUG_MODE`	`pinepods`	—
`PEOPLE_API_URL`	`pinepods`	—
`PGID`	`pinepods`	—
`PUID`	`pinepods`	—
`SEARCH_API_URL`	`pinepods`	—
`VALKEY_HOST`	`pinepods`	—
`VALKEY_PORT`	`pinepods`	—
`POSTGRES_BACKUP_RETENTION`	`pinepods_db`	—
`POSTGRES_BACKUP_SCHEDULE`	`pinepods_db`	—
`POSTGRES_PASSWORD`	`pinepods_db`	—
`TZ`	`pinepods_db`	`Australia/Sydney`
`CHECK_FREQUENCY`	`podgrab`	—
`PGID`	`soulseek`	—
`PUID`	`soulseek`	—
`TZ`	`soulseek`	`Australia/Sydney`
`STASH_CACHE`	`stash`	—
`STASH_GENERATED`	`stash`	—
`STASH_METADATA`	`stash`	—
`STASH_PORT`	`stash`	—
`STASH_STASH`	`stash`	—
`PGID`	`tautulli`	—
`PUID`	`tautulli`	—
`TZ`	`tautulli`	`Australia/Sydney`
`TZ`	`ytvids-pinchflat`	`Australia/Sydney`

6. Access & Usage

Service	URL
Booklore	`https://booklore.m1ckyb.com`
Jellystat	`https://jellystat.home-lab.micky.id.au`
Pinepods	`https://pinepods.home-lab.micky.id.au`
Tautulli	`https://tautulli.home-lab.micky.id.au`
Pinchflat	`https://pinchflat.home-lab.micky.id.au`
gPodder	`https://gpodder.m1ckyb.com`

docker compose -f Homelab/Media/services/compose.yaml up -d

7. Maintenance & Backup

docker compose -f Homelab/Media/services/compose.yaml pull
docker compose -f Homelab/Media/services/compose.yaml up -d

# Backup configs (media files live on NFS)
rsync -av /docker/data/media/ /backup/media/