datarhei Restreamer mit Docker Compose installierenUbuntu- & Debian-Anleitung

Inhalt der Anleitung

• 1. Voraussetzungen
• 2. Docker installieren
• 3. Restreamer bereitstellen
• 4. Ports und Firewall
• 5. Weboberfläche starten
• 6. Quelle und Ziel einrichten
• 7. Sicherheit und HTTPS
• 8. Update, Backup und Fehlerdiagnose
• 9. Passendes Video
• 10. Häufige Fragen

1. Voraussetzungen und System prüfen

Diese Anleitung ist für die aktuell von Docker unterstützten 64-Bit-Systeme ausgelegt:

• Ubuntu: 26.04 LTS, 24.04 LTS oder 22.04 LTS
• Debian: 13 Trixie oder 12 Bookworm
• öffentliche IP oder passende Routerweiterleitungen
• Root-Zugang beziehungsweise ein Benutzer mit sudo-Rechten
• ausreichender Upload und genügend CPU-Leistung, besonders bei Transcoding

Zeige Distribution, Version und Architektur an:

cat /etc/os-release && \
dpkg --print-architecture

Wechsle anschließend in eine Root-Shell. Unter Ubuntu:

sudo -i

Unter Debian ohne eingerichtetes sudo:

su -

Wenn dein Prompt bereits root@… zeigt, bist du schon Root.

2. Docker Engine und Compose installieren

Vorhandenes Docker zuerst prüfen

Wenn Docker bereits installiert ist und andere Container laufen, ersetze keine Pakete unüberlegt. Auf einem frischen Server kannst du mit dpkg -l docker.io docker-compose docker-compose-v2 containerd runc nach Konfliktpaketen sehen. Falls solche Pakete vorhanden sind, folge dem Abschnitt „Uninstall old versions“ der unten verlinkten offiziellen Docker-Anleitung für dein System. Der folgende Ablauf setzt einen konfliktfreien Server voraus.

Grundpakete installieren

apt update && \
apt install ca-certificates curl -y && \
install -m 0755 -d /etc/apt/keyrings

Variante A: Ubuntu 26.04, 24.04 oder 22.04

curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc && \
chmod a+r /etc/apt/keyrings/docker.asc && \
tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

Variante B: Debian 13 oder 12

curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc && \
chmod a+r /etc/apt/keyrings/docker.asc && \
tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

Docker auf beiden Systemen installieren und prüfen

apt update && \
apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y && \
systemctl enable --now docker && \
docker run --rm hello-world && \
docker compose version

Offizielle Quellen: Docker unter Ubuntu und Docker unter Debian.

3. Restreamer mit Compose bereitstellen

Der Container stammt direkt aus dem offiziellen datarhei-Projekt. Diese Anleitung verwendet das Multiarch-Image datarhei/restreamer:latest, das Docker passend zur Prozessorarchitektur lädt.

Restreamer bei datarhei ansehen Fertige Compose-Datei herunterladen

Lade die vorbereitete Datei direkt in das Installationsverzeichnis:

install -d -m 0755 /opt/restreamer/config /opt/restreamer/data && \
curl -fsSL --retry 3 https://irl4you.de/downloads/compose-restreamer.yaml -o /opt/restreamer/compose.yaml && \
chown root:root /opt/restreamer/compose.yaml && \
chmod 0644 /opt/restreamer/compose.yaml

Die Datei verwendet die von datarhei dokumentierten Speicherpfade und Ports:

services:
  restreamer:
    image: datarhei/restreamer:latest
    container_name: restreamer
    restart: unless-stopped
    ports:
      - "8080:8080/tcp"
      - "8181:8181/tcp"
      - "1935:1935/tcp"
      - "1936:1936/tcp"
      - "6000:6000/udp"
    volumes:
      - /opt/restreamer/config:/core/config
      - /opt/restreamer/data:/core/data

Container herunterladen und starten:

cd /opt/restreamer && \
docker compose config && \
docker compose pull && \
docker compose up -d && \
docker compose ps

4. Ports und Firewall

Für SSH und andere Dienste direkt auf dem Host kannst du UFW einsetzen. Prüfe vor dem Aktivieren, ob der angezeigte Port wirklich zu deiner aktuellen SSH-Verbindung passt; bei mehreren SSH-Ports musst du alle verwendeten Ports freigeben. Führe den folgenden Block erst aus, wenn das stimmt:

SSH_PORT=$(/usr/sbin/sshd -T | awk '$1=="port" {print $2; exit}') && \
test -n "$SSH_PORT" && \
printf 'Erkannter SSH-Port: %s\n' "$SSH_PORT" && \
apt install ufw -y && \
ufw allow "${SSH_PORT}/tcp" && \
ufw default deny incoming && \
ufw default allow outgoing && \
ufw --force enable && \
ufw status verbose

5. Weboberfläche und ersten Benutzer einrichten

Öffne nach dem Start im Browser:

http://DEINE-SERVER-IP:8080/ui

Lege beim ersten Aufruf einen eigenen Administratorzugang mit langem, einmaligem Passwort an. Danach führt der Assistent durch Videoquelle, Audio und gewünschte Veröffentlichung. Nutze keine Beispielkennwörter und veröffentliche die Verwaltungsoberfläche nicht dauerhaft ungeschützt.

Prüfe den Container bei Problemen:

cd /opt/restreamer && \
docker compose ps && \
docker compose logs --tail=100

6. Quelle und Ziel einrichten

1. In der Restreamer-Weboberfläche eine neue Videoquelle anlegen.
2. Passendes Eingangsprotokoll wählen: RTMP, RTMPS, SRT oder eine andere unterstützte Quelle.
3. Die angezeigte Serveradresse und den Stream-Key in Smartphone-App, Encoder oder OBS übernehmen.
4. Bild, Ton, Codec und Eingangsbitrate in der Vorschau prüfen.
5. Unter Veröffentlichung das gewünschte Ziel anlegen und dessen Serveradresse sowie Stream-Key eintragen.
6. Zuerst einen privaten Teststream starten und Bild, Ton sowie Stabilität am Ziel kontrollieren.

7. Sicherheit und HTTPS

• Administratorpasswort und sämtliche Stream-Keys einmalig und schwer erratbar wählen.
• Verwaltungsoberfläche möglichst auf bekannte IP-Adressen, VPN oder internes Netz begrenzen.
• Für öffentliche Player und Logins HTTPS verwenden.
• Nur benötigte Streaming-Ports freigeben.
• Keine Zugangsdaten in Screenshots, Videos, Logs oder Support-Chats veröffentlichen.

Die offizielle Portweiterleitung sieht für einen öffentlichen Betrieb typischerweise 80 → 8080 und 443 → 8181 vor. Ob Restreamers automatische Zertifikatsfunktion oder ein eigener Reverse Proxy sinnvoller ist, hängt von Domain, Router und vorhandener Serverstruktur ab.

8. Update, Backup und Fehlerdiagnose

Aktualisieren

cd /opt/restreamer && \
docker compose config && \
docker compose pull && \
docker compose up -d

Konfiguration und Daten sichern

tar -C / -czf /root/restreamer-backup-$(date +%F-%H%M%S).tar.gz \
  opt/restreamer/config \
  opt/restreamer/data \
  opt/restreamer/compose.yaml

Live-Protokoll ansehen

cd /opt/restreamer && \
docker compose logs -f --tail=200

Root-Shell verlassen

exit

Weitere Details: offizielle datarhei-Webseite, Restreamer Quick Start und datarhei Restreamer auf GitHub.

9. Video: Restreamer auf einer virtuellen Maschine installieren

Das Video von Akinos01 „Akinos“ zeigt die Restreamer-Installation auf einer virtuellen Maschine als praktische Ergänzung zu dieser schriftlichen Anleitung.

Schriftliche Alternative zum Video: Die Schritte zu Docker, Compose-Konfiguration und Start und Prüfung stehen direkt auf dieser Seite.

10. Häufige Fragen

Danke an das datarhei-Team

Ein herzliches Dankeschön geht an die Entwicklerinnen, Entwickler und Mitwirkenden des datarhei Restreamers. Mit dem frei verfügbaren Open-Source-Projekt, dem offiziellen Docker-Image und der ausführlichen Dokumentation stellen sie der Streaming-Community eine leistungsfähige Lösung zum selbstständigen Hosten und Verteilen von Livestreams zur Verfügung.

Diese IRL4YOU-Anleitung ist eine eigenständig erstellte deutschsprachige Praxishilfe. Sie steht in keiner offiziellen Verbindung zum datarhei-Projekt. Fehlerberichte, Quellcode und Beiträge zum Originalprojekt gehören direkt in das offizielle Restreamer-Repository auf GitHub.