livetv

Self-hosted live-TV stack: an Xtream IPTV source is mirrored through this VPS and served to Jellyfin so it can be watched ad-free in Jellyfin's apps.

Xtream provider (API only)
        │  player_api.php  (URL + username + password)
        ▼
   Dispatcharr        ← ingests via the Xtream API, regenerates a clean
        │               HDHomeRun tuner + M3U + EPG
        ▼
    Jellyfin          ← Live TV: adds Dispatcharr as a tuner + guide
        │
        ▼
  Jellyfin apps (HTTPS via Nginx Proxy Manager)

Both services run on the shared external Docker network proxy, where Nginx Proxy Manager (NPM) reaches them by name — no raw host ports are opened.

Services

Service	Internal address	Public (via NPM)
`jellyfin`	`jellyfin:8096`	`https://jellyfin.altricade.com`
`dispatcharr`	`dispatcharr:9191`	`https://dispatcharr.altricade.com` (admin, behind an Access List)

Deploy

Pushing to master triggers .forgejo/workflows/deploy.yaml, which runs docker compose up -d on the VPS runner. The compose project name is pinned to livetv so the named volumes persist across deploys.

git add -A
git commit -m "..."
git push origin master

NPM proxy hosts

Create two hosts (both forward over the proxy network, scheme http, Websockets on, SSL via Let's Encrypt):

jellyfin.altricade.com → jellyfin : 8096
dispatcharr.altricade.com → dispatcharr : 9191 (add an Access List — this is the admin UI)

First-time configuration

Dispatcharr (https://dispatcharr.altricade.com): create admin login → add an Xtream Codes account (server URL + username + password) → let it scan channels via the API → add the EPG source.
Jellyfin (https://jellyfin.altricade.com): Dashboard → Live TV →
- Tuner Devices → add HDHomeRun http://dispatcharr:9191 (or an M3U Tuner).
- TV Guide Data → add XMLTV using Dispatcharr's EPG URL.
- Refresh guide and map channels.

Notes

No credentials are stored in this repo. The Xtream login is entered in the Dispatcharr UI and lives in the dispatcharr_data volume on the VPS.
Confirm the shared network is named proxy (docker network ls); adjust docker-compose.yaml if NPM is on a different network.

2.4 KiB Raw Blame History