IPTV-webapp

Je eigen IPTV-dienst met Docker

Draai je eigen versie van deze dienst, met je eigen naam, adres en IPTV-abonnement: een website in de stijl van Videoland en een eigen Android-app voor tv en telefoon. Installeren duurt ongeveer 20 minuten.

Download het installatiepakket Bijwerken en wat er nieuw is .tar.gz · bevat geen wachtwoorden of gegevens

Wat je krijgt

Wat je nodig hebt

• Een Linux-computer, NAS of VPS met Docker Engine, met Portainer of Docker Compose v2.
• Minimaal 4 GB werkgeheugen en 8 GB vrije schijfruimte.
• Een IPTV-abonnement: Xtream Codes (server, gebruikersnaam, wachtwoord) of een M3U-link.
• Een adres waarop de dienst bereikbaar is. Voor de app en Chromecast is https nodig: een eigen domein, of een reverse proxy zoals Pangolin of Nginx Proxy Manager.

Installeren met Portainer (aanbevolen)

Gebruik je Portainer? Dan installeer je alles als één stack, zonder iets te downloaden of te bouwen. De containers halen de software zelf op.

1. Maak een nieuwe stack: Portainer → Stacks → Add stack. Geef hem een naam, bijvoorbeeld hoekitv, kies Web editor en plak deze stack:

   Laden…

   Kopiëren

   Ook te openen als bestand: portainer-stack.yml

2. Vul de omgevingsvariabelen in. Klik onder de editor bij Environment variables op Advanced mode, plak dit en pas de waarden aan:

   APP_NAME=HoekiTV
   PUBLIC_URL=https://tv.mijndomein.nl
   LAN_URL=
   ADMIN_USER=admin
   ADMIN_PASSWORD=kies-een-sterk-wachtwoord
   HTTP_PORT=8080
   IPTV_SERVER=http://provider.example:8080
   IPTV_USERNAME=
   IPTV_PASSWORD=
   IPTV_M3U_URL=
   IPTV_TYPE=
   IPTV_MAX_STREAMS=

   Kopiëren

   Variabele	Betekenis
   APP_NAME	Naam van jouw dienst en app
   PUBLIC_URL	Adres waarop jij en de app de dienst bereiken (https aanbevolen)
   LAN_URL (optioneel)	Intern adres, bijv. http://192.168.1.10:8080. De app gebruikt dat thuis automatisch: sneller zappen, niet via de proxy
   ADMIN_USER / ADMIN_PASSWORD	Jouw beheerdersaccount, alleen gebruikt bij de eerste start
   HTTP_PORT	Poort op je server; zet je reverse proxy (Nginx Proxy Manager, Traefik, Pangolin) hierop
   IPTV_*	Xtream: server + gebruikersnaam + wachtwoord, of alleen IPTV_M3U_URL. Leeg laten mag: dan stel je het later in de website in
   IPTV_TYPE (optioneel)	dispatcharr als je Dispatcharr gebruikt: IPTV_SERVER = adres van Dispatcharr (bijv. http://dispatcharr:9191), gebruikersnaam + XC-wachtwoord van een Dispatcharr-gebruiker. Dispatcharr kan ook in dezelfde stack draaien: zie het blok dispatcharr in de stack
   IPTV_MAX_STREAMS (optioneel)	Hoeveel streams tegelijk mogen (kijkers + opnames). Leeg = wat de provider opgeeft, anders 1. Later aan te passen in Instellingen > IPTV-bron > Geavanceerd

3. Klik op Deploy the stack. Na ongeveer een minuut is de website bereikbaar op http://<server>:8080 of via je eigen domein.
4. Log in als beheerder en ga naar Instellingen → Android TV-app → Nieuwe app-versie bouwen. De eerste keer installeert de APK-builder zijn bouwomgeving; dat duurt 10–20 minuten. Volg de voortgang in Portainer bij de logs van de container apk-builder.

Bereikbaar maken via een reverse proxy

De stack opent de app alleen op http://<server>:HTTP_PORT. Voor een eigen domein met https zet je je eigen reverse proxy ervoor. Https is nodig voor Chromecast; de Android-app werkt ook via http, maar dan onversleuteld.

Altijd instellen

Wil je toch authenticatie op de proxy, maak dan uitzonderingen (bypass) voor /play/*, /p/*, /img/*, /apk/* en /api/*.

Pangolin

1. Maak in Pangolin een site van het type Newt en noteer endpoint, ID en secret.
2. Haal in de stack de # weg bij de service newt en zet PANGOLIN_ENDPOINT, NEWT_ID en NEWT_SECRET bij de omgevingsvariabelen. Draait Newt al ergens anders in je netwerk, dan sla je deze stap over.
3. Maak een resource met je domein. Doel: app poort 8080 (Newt in de stack), of <ip-van-de-server> poort HTTP_PORT (Newt elders).
4. Zet authenticatie voor deze resource uit en zet PUBLIC_URL op het https-adres.

Nginx Proxy Manager

1. Add Proxy Host: je domein → scheme http, host <ip-van-de-server>, poort HTTP_PORT.
2. Tab SSL: Let's Encrypt-certificaat aanvragen, Force SSL aan.
3. Tab Advanced, plak:

   proxy_buffering off;
   proxy_request_buffering off;
   proxy_read_timeout 3600s;
   proxy_send_timeout 3600s;

   Kopiëren

Traefik

Voeg aan de service app de gebruikelijke labels toe (router met je domein en certresolver, service-poort 8080) en hang hem aan je Traefik-netwerk. Traefik buffert standaard niet; er is verder niets bijzonders nodig.

Of: installeren met het installatiescript

Zonder Portainer gebruik je het installatiescript op de Docker-machine:

1. Download en pak het pakket uit op de Docker-machine:

   curl -fsSL https://videoland.amsterdam2.nl/download/iptv-webapp-docker.tar.gz | tar -xz
   cd iptv-webapp/docker

   Kopiëren
2. Start de installatie en beantwoord de vragen (zie de tabel hieronder):

   chmod +x install.sh
   ./install.sh

   Kopiëren
3. Wacht tot alles gebouwd is. De eerste keer duurt dit 10–20 minuten, omdat de Android-bouwomgeving wordt gedownload. Daarna bouwt het script meteen de eerste Android-app.
4. Open je adres in de browser en log in met het beheerdersaccount. Onder Instellingen zie je het abonnement, de gebruikers en de Android-app.

Wat het installatiescript vraagt

De Android-app verspreiden

1. Ga in de website naar Instellingen → Android TV-app → Downloadcode maken.
2. Op de tv-box: installeer Downloader uit de Play Store, sta "onbekende apps installeren" toe voor Downloader en typ het getoonde adres in.
3. De app logt automatisch in met een geheime sleutel van jouw server. Er staat geen wachtwoord in de app.

Nieuwe versie: kies Nieuwe app-versie bouwen in hetzelfde paneel. Alle apps tonen dan "Update vereist" en werken zichzelf bij.

Beheer

Voer deze opdrachten uit in de map iptv-webapp/docker:

Naam of adres wijzigen: pas .env aan, voer docker compose up -d uit en bouw een nieuwe app-versie.

Meerdere diensten op één machine

Pak het pakket per dienst uit in een eigen map (bijvoorbeeld tv-familie en tv-vrienden) en voer in elke map ./install.sh uit, met een andere app-naam en poort. Elke dienst krijgt eigen containers, gegevens en een eigen app. Gebruik dan één reverse proxy voor https in plaats van Caddy per dienst.

Problemen oplossen