Telerising API per Docker installieren – die funktionierende Anleitung (2026)

Wer im Netz nach der Installation der Telerising API sucht, stößt aktuell überall auf denselben Stolperstein: Das offizielle GitHub-Repository sunsettrack4/telerising-api enthält im Hauptbranch nur noch eine README.md – der eigentliche Programmcode fehlt komplett. Wer versucht, das Repo per git clone oder als ZIP herunterzuladen, bekommt deshalb nur eine leere Hülle.

Diverse KI-Chatbots (ChatGPT, Meta AI, Gemini) erklären das Projekt daraufhin fälschlicherweise für tot oder faseln von angeblichen DRM-Sperren. Beides stimmt nicht. Die Lösung ist simpel, wenn man weiß, wo man suchen muss.

Diese Anleitung ist für Debian 12 (ohne grafische Oberfläche, per SSH) getestet, funktioniert aber sinngemäß auf jedem Linux-System mit Docker.

Was hier wirklich das Problem ist

1. Der Code liegt nicht im Git-Branch, sondern ausschließlich als ZIP-Datei in den GitHub Releases des Projekts. Ein normaler git clone oder Branch-Download bringt deshalb nie den Code mit.
2. Das früher gängige Docker-Image von DeBaschdi (stucki/telerising u. ä.) versucht selbst automatisch, dieses Release-ZIP zu laden – dieser Update-Mechanismus ist seit einiger Zeit defekt.
3. Die Community hat daher ein aktiv gepflegtes Ersatz-Image gebaut: starfoxfs/telerising (Docker Hub), das den Download zuverlässig selbst erledigt.
4. Dieses Image bringt allerdings kein ffmpeg mit – ohne ffmpeg lassen sich zwar die Sender auflisten, aber keine Videos abspielen (Fehler hls:networkError_manifestLoadTimeOut oder ähnliche Player-Fehler).
5. Zusätzlich muss die eigene LAN-IP-Adresse in den API-Einstellungen hinterlegt werden – sonst zeigen die generierten Stream-Links auf die interne Docker-Netzwerkadresse und der Player kann sie nicht laden.

Mit den folgenden Schritten ist das Setup in wenigen Minuten fertig.

Voraussetzungen

• Ein Linux-Server/Client mit Docker und Docker Compose (Plugin docker compose, nicht das alte docker-compose)
• SSH-Zugriff
• Die LAN-IP deines Servers (herausfinden mit ip a oder hostname -I)

Schritt 1: Projektordner anlegen

mkdir -p ~/telerising/build
mkdir -p ~/telerising/telerising
cd ~/telerising

Schritt 2: Eigenes Dockerfile mit ffmpeg erstellen

Das Basis-Image bringt kein ffmpeg mit, das rüsten wir hier nach:

cat > ~/telerising/build/Dockerfile << 'EOF'
FROM starfoxfs/telerising:latest

RUN apt-get update && \
    apt-get install -y --no-install-recommends ffmpeg && \
    rm -rf /var/lib/apt/lists/*
EOF

Schritt 3: docker-compose.yml anlegen

cat > ~/telerising/docker-compose.yml << 'EOF'
services:
  telerising:
    build: ./build
    container_name: telerising
    restart: unless-stopped
    environment:
      - TZ=Europe/Berlin
    ports:
      - "5000:5000"
    volumes:
      - ./telerising:/telerising
EOF

Schritt 4: Container bauen und starten

docker compose up -d --build

Der erste Build dauert je nach Server ein paar Minuten (ffmpeg-Installation). Fortschritt live mitverfolgen:

docker logs -f telerising

Wenn am Ende sinngemäß erscheint:

Telerising-API is running on:
http://yourserverip:5000

… hat der Container erfolgreich gestartet und das aktuelle API-Release heruntergeladen.

Schritt 5: ffmpeg-Installation prüfen

docker exec -it telerising ffmpeg -version

Es sollte eine Versionsnummer ausgegeben werden (kein „not found“).

Schritt 6: Eigene LAN-IP ermitteln

ip a

Achte auf die Netzwerkschnittstelle mit deinem Heimnetz (z. B. enp1s0 oder eth0) und notiere die inet-Adresse, z. B. 192.168.1.50.

Schritt 7: Web-Interface öffnen und konfigurieren

Im Browser eines beliebigen Geräts im selben Netzwerk aufrufen:

http://DEINE-SERVER-IP:5000

Dort unter Settings → Custom IP address / domain path eintragen:

http://DEINE-SERVER-IP:5000

(ersetze DEINE-SERVER-IP durch die IP aus Schritt 6) und Save klicken.

Dieser Schritt ist entscheidend. Ohne ihn zeigen die generierten Stream-Links auf die interne Docker-IP (z. B. 172.18.0.2), die von außen nicht erreichbar ist – die Videos laden dann nicht, obwohl ffmpeg korrekt installiert ist.

Schritt 8: Provider einrichten und testen

Unter Add provider deinen Anbieter (Zattoo, Waipu.tv, Blue TV, Sky CH …) mit den Zugangsdaten hinterlegen, danach einen Sender testweise abspielen.

Fertig!

Ab jetzt läuft die Telerising API stabil und übersteht auch Neustarts (restart: unless-stopped). Bei einem Update des Basis-Images einfach erneut ausführen:

cd ~/telerising
docker compose down
docker compose up -d --build

---

Kurzübersicht – die häufigsten Fehler

Symptom	Ursache	Lösung
Nur README.md beim Klonen von GitHub	Code liegt nur in den Releases, nicht im Branch	Fertiges Docker-Image starfoxfs/telerising statt eigenem Git-Clone verwenden
./api: No such file or directory	Alter Update-Mechanismus des DeBaschdi-Images defekt	Auf starfoxfs/telerising wechseln
Kanäle sichtbar, aber kein Video, Fehler hls:networkError_manifestLoadTimeOut	ffmpeg fehlt im Container	Eigenes Dockerfile mit apt-get install ffmpeg verwenden
Video lädt trotz ffmpeg nicht, Stream-URL enthält eine 172.x.x.x-Adresse	Custom IP address / domain path nicht gesetzt	Eigene LAN-IP unter Settings eintragen

Kein DRM-Problem, keine „toten“ GitHub-Dateien – nur ein bisschen Docker-Detektivarbeit.