Voraussetzungen

Server-Anforderungen

DNS-Voraussetzung

Du brauchst einen A-Record für deine Panel-Domain, der auf die Server-IP zeigt:

panel.deine-domain.de.  IN  A  1.2.3.4

Lizenzen (durch Heiko einzutragen)

Vor dem Install müssen zwei Lizenzen im Backend eingetragen sein:

1. DGNCast-Lizenz – mit der exakten Panel-Domain als Scope (wird von Heiko eingetragen)
2. HDEncoder-Lizenz – selbe Domain wie die DGNCast-Lizenz (wird von Heiko eingetragen)

Der Installer zieht die Lizenzen automatisch, du musst nichts eintragen.

Plesk-Server

Der Installer erkennt Plesk automatisch (/usr/local/psa oder /opt/psa). Apache-VHost und UFW werden dann übersprungen. Die Anleitung für die manuelle Konfiguration findest du nach der Installation unter /opt/dgncast-panel-php/PLESK-SETUP.txt.

Server installieren

Installer-Befehl

ssh root@dein-server.de
curl -fsSL https://cast.dgnshop.com/setup/install.sh | bash

Interaktive Abfragen

• Panel-Domain – z.B. panel.deine-domain.de
• E-Mail – für Let's Encrypt-Zertifikat
• Admin-Passwort – mindestens 12 Zeichen, unbedingt notieren!

Was der Installer macht (12 Phasen, ca. 5–8 Min.)

1. Konfiguration sammeln + DGNCast-Lizenz vom Lizenzserver ziehen
2. System-Pakete: curl, wget, jq, PHP 8.5 + Extensions
3. HDEncoder PHP-Extension installieren + Lizenz automatisch freigeben
4. Apache 2 + SSL-Module aktivieren
5. Certbot für Let's Encrypt
6. Node.js 22 LTS + ffmpeg
7. Systemd-User + Panel-Verzeichnis /opt/dgncast-panel-php
8. Panel-Tarball entpacken
9. DGNCast-Server-Tarball entpacken + npm install
10. Zwei systemd-Services starten (Panel Port 8090, DGNCast-Server Port 8010)
11. Apache-VHost + SSL-Zertifikat + UFW-Firewall
12. Verifikations-Report generieren

Nach der Installation

Das Panel ist erreichbar unter:

https://deine-panel-domain.de/admin

Login: Benutzername admin, Passwort wie beim Install eingegeben.

DGNCast-Server verbinden

Das Panel verwaltet Streams, der eigentliche Streaming-Dienst ist der DGNCast-Server – ein Node.js-Dienst der nach der Installation bereits läuft.

Standard-Konfiguration (alles auf einem Server)

Wenn Panel und DGNCast-Server auf demselben Rechner laufen (Normalfall nach automatischer Installation):

API-Passwort nachschlagen

Falls du das Passwort nicht mehr weißt, findest du es auf dem Server:

cat /opt/dgncast/config.json | grep password

Verbindungstest schlägt fehl?

• Läuft der DGNCast-Server? systemctl status dgncast-server
• Läuft er auf Port 8010? ss -tlnp | grep 8010
• Stimmt das Passwort mit /opt/dgncast/config.json überein?

Externer Server (fortgeschritten)

Du kannst auch einen DGNCast-Server auf einem anderen Rechner verbinden. Trage als Base URL die externe IP oder Domain ein, z.B. http://stream.deine-domain.de:8010. Port 8010 muss in der Firewall freigegeben sein.

Pläne anlegen

Pläne definieren die Ressourcen die einem Stream oder Kunden zur Verfügung stehen (Bitrate, Hörer-Slots, Speicher).

Neuen Plan anlegen

1. 1
   Im Panel: Pläne → Neuen Plan erstellen
2. 2
   Name vergeben (z.B. "Starter 128k", "Pro 320k")
3. 3
   Bitrate-Limit in kbps, max. gleichzeitige Hörer und Speicher-Kontingent eintragen
4. 4
   Speichern

Typische Plan-Konfigurationen

Kunden anlegen Nur Reseller-Tier

Im Reseller-Tier kannst du Unterkonten für deine Kunden anlegen. Jeder Kunde sieht nur seine eigenen Daten und Streams.

Neuen Kunden anlegen

1. 1
   Im Panel: Kunden → Neuen Kunden anlegen
2. 2
   Name, E-Mail und Passwort eingeben
3. 3
   Plan zuweisen (vorher anlegen unter Pläne anlegen)
4. 4
   Optional: Ablaufdatum für zeitbegrenzte Accounts
5. 5
   Erstellen

Kunden sperren / löschen

Unter Kunden → [Kundenname] → Bearbeiten kannst du Plan, Passwort und Status ändern. Gesperrte Kunden können sich nicht mehr einloggen, ihre Streams werden angehalten.

Streams anlegen

Ein Stream entspricht einem Radiosender. Du kannst mehrere Streams parallel betreiben.

Neuen Stream anlegen

1. 1
   Im Panel: Streams → Neuen Stream anlegen
2. 2
   Stream-Name und Beschreibung eingeben
3. 3
   Bitrate wählen (muss im Plan-Limit liegen)
4. 4
   Mount-Point festlegen, z.B. /radio oder /live
5. 5
   Passwort für Broadcastsoftware setzen
6. 6
   Stream erstellen

Sendesoftware verbinden

Verbindungsdaten für BUTT, MIXXX, SAM Broadcaster, Liquidsoap & Co. (Icecast2-kompatibel):

Troubleshooting

Panel nicht erreichbar

systemctl status dgncast-panel-php
systemctl status apache2
journalctl -u dgncast-panel-php -n 50

DGNCast-Server läuft nicht

systemctl status dgncast-server
journalctl -u dgncast-server -n 50
# Manuell testen:
curl http://127.0.0.1:8010/api/status

HDEncoder-Fehler (Panel leer oder PHP-Fehler)

php -m | grep hdencoder
# Falls leer: .ini prüfen
ls /etc/php/8.5/*/conf.d/ | grep hdencoder
# Notfall-Repair:
find /usr/lib/php -name hdencoder.so
echo 'extension=hdencoder.so' > /etc/php/8.5/mods-available/hdencoder.ini
phpenmod -v 8.5 hdencoder
systemctl restart dgncast-panel-php

Let's Encrypt schlägt fehl

# Zertifikat manuell anfordern:
certbot --apache -d deine-panel-domain.de

Lizenz-Fehler beim Install

• Heiko hat die Lizenz noch nicht für diese Domain eingetragen
• Der A-Record zeigt noch nicht auf diesen Server
• Tippfehler in der Domain beim Installer-Dialog

Wende dich in diesem Fall direkt an Heiko – er kann den Lizenzstatus prüfen und korrigieren.

Alle Services neu starten

systemctl restart dgncast-panel-php dgncast-server apache2

Installer erneut ausführen

Der Installer ist idempotent – kann auf einem bestehenden Server nochmal ausgeführt werden.

curl -fsSL https://cast.dgnshop.com/setup/install.sh | bash

FAQ

Kann ich das Panel auf einem Plesk-Server installieren?

Ja. Der Installer erkennt Plesk automatisch. Die VHost-Konfiguration machst du dann manuell nach der Anleitung in /opt/dgncast-panel-php/PLESK-SETUP.txt.

Welche Sendesoftware wird unterstützt?

Alles Icecast2-kompatible: BUTT, MIXXX, SAM Broadcaster, Rocket Broadcaster, Liquidsoap, Traktor (mit Plugin) u.v.m.

Können Panel und DGNCast-Server auf verschiedenen Servern laufen?

Ja. Du kannst unter Server → Neuen Server verbinden beliebige externe URLs eintragen. Port 8010 muss in der Firewall freigegeben sein.

Wie viele Hörer kann ein Server verkraften?

Abhängig von der Netzwerkbandbreite. Faustformel: 1 Mbit/s Upload = ca. 7 Hörer bei 128 kbps. Ein Hetzner CX22 (20 TB Traffic) reicht für die meisten kleinen bis mittleren Sender.

Was passiert wenn meine Lizenz abläuft?

Das Panel zeigt eine Warnung an. Kontakt: support@dgnshop.com

Gibt es eine API?

Der DGNCast-Server hat eine REST-API intern auf Port 8010. Das Panel selbst hat aktuell keine öffentliche API.

Wie sichere ich die Konfiguration?

Siehe Backup & Wiederherstellung.

Backup & Wiederherstellung

Was sichern?

Backup-Skript

#!/bin/bash
STAMP="$(date +%F-%H%M)"
BACKUP="/root/backups/panel-$STAMP"
mkdir -p "$BACKUP"
cp /opt/dgncast-panel-php/config.json "$BACKUP/"
cp -r /opt/dgncast-panel-php/data/ "$BACKUP/data/"
cp /opt/dgncast/config.json "$BACKUP/dgncast-config.json"
tar czf "$BACKUP.tar.gz" "$BACKUP/" && rm -rf "$BACKUP"
echo "Backup: $BACKUP.tar.gz"

Cronjob (täglich um 3 Uhr)

# crontab -e
0 3 * * * /root/backup-panel.sh >> /var/log/panel-backup.log 2>&1

Wiederherstellung

systemctl stop dgncast-panel-php
tar xzf /root/backups/panel-DATUM.tar.gz -C /tmp/
cp /tmp/panel-DATUM/config.json /opt/dgncast-panel-php/
cp -r /tmp/panel-DATUM/data/ /opt/dgncast-panel-php/data/
chown -R dgncast-panel-php:dgncast-panel-php \
  /opt/dgncast-panel-php/data \
  /opt/dgncast-panel-php/config.json
systemctl start dgncast-panel-php