DGNCast Streamserver-Panel

Das Handbuch: von der Installation bis zum laufenden Sender

Das DGNCast Streamserver-Panel ist die Verwaltungs-Oberfläche für deinen eigenen Webradio-Streamserver. Du verwaltest damit Streams, DJ-Accounts, AutoDJ-Playlisten und Hörer-Statistiken, ganz ohne Kommandozeile. Als Reseller hostest du komplette Radio-Stationen für eigene Kunden, jede mit eigenem Login und eigenem Portal. Dieses Handbuch führt dich durch alle Funktionen.

Standard oder Reseller? Erst die wichtigste Frage

Das Panel gibt es in zwei Ausbaustufen. Welche du hast, steht in deiner Lizenz und entscheidet, welche Menüpunkte du siehst.

Wenn du im Menü Pläne, Kunden und Hosting nicht siehst, läuft dein Panel im Standard-Modus. Ein Upgrade auf Reseller ist jederzeit möglich, schreib uns an support@dgnshop.com.

Was du konkret damit machen kannst

Dein eigenes Radio betreiben (Standard)

Du verbindest deinen DGNCast-Server, legst einen Stream an und gibst deinen DJs persönliche Zugänge. AutoDJ spielt deine Musik, wenn gerade kein DJ live ist. Die öffentliche Player-Seite teilst du mit deinen Hörern.

Radio-Hosting verkaufen (Reseller)

Du legst Pakete an (z.B. "128 kbps, 500 Hörer"), erstellst Kunden und provisionierst per Klick eine komplette eigene Streamserver-Instanz pro Kunde. Jeder Kunde loggt sich in sein eigenes Portal ein und verwaltet seine Streams, DJs und Musik selbst, mit deinem Branding und deinem Impressum.

Von AzuraCast umziehen

Du verbindest dein altes AzuraCast, wählst eine Station und das Panel zieht Kunde, Stream und AutoDJ-Dateien automatisch zu DGNCast um. Die DJs bekommen automatisch eine Mail zum Passwort-Setzen.

Installation in Kürze

Das Panel läuft auf deinem eigenen Root-Server (nicht auf Shared Hosting). Die vollständige Schritt-für-Schritt-Anleitung mit allen Server-Befehlen liegt der Lieferung als INSTALL.md bei. Die Kurzfassung:

1. Server: Root-Server mit Debian 12 oder Ubuntu 22.04/24.04, mindestens 1 GB RAM, eine (Sub-)Domain mit A-Record auf die Server-IP.
2. PHP 8.5 installieren (Pflicht für den HDEncoder-Schutz) plus die HDEncoder-Extension (curl -fsSL https://get.hdencoder.cloud/install.sh | bash).
3. Panel-Dateien nach /opt/dgncast-panel-php/ kopieren, Service-User anlegen, config.json mit deinem Admin-Passwort ausfüllen.
4. systemd-Service starten (das Panel läuft intern auf Port 8090).
5. Apache als Reverse-Proxy davorsetzen und mit Let's Encrypt ein SSL-Zertifikat holen.
6. Im Browser https://panel.deine-domain.de/admin/login öffnen.

Faustregel: Panel und DGNCast-Streamserver laufen am besten auf demselben Server. Das spart Latenz und Konfiguration.

Lizenz aktivieren

Nach dem Kauf bekommst du deinen Lizenz-Schlüssel per E-Mail. Du aktivierst ihn direkt im Panel, es gibt zwei Wege, beide unter Admin → Lizenz:

Weg 1: Datei hochladen (am einfachsten)

1. Speichere den Anhang aus der Kauf-Mail als license.key auf deinem Rechner.
2. Im Panel Admin → Lizenz öffnen.
3. Unter "Lizenz-Datei hochladen" die license.key auswählen.
4. Lizenz aktivieren klicken. Fertig.

Weg 2: Text einfügen

1. Öffne die Kauf-Mail und kopiere den kompletten Lizenz-Block, inklusive der geschweiften Klammern. Er sieht so aus:

   { "payload": { ... }, "signature": "..." }
   

2. Im Panel Admin → Lizenz den Block in das Textfeld "Lizenz-Schlüssel" einfügen.
3. Lizenz aktivieren klicken.

Das Panel prüft die Signatur und schaltet sofort alle Funktionen deines Tarifs frei. Du siehst dann oben "Deine Lizenz ist aktiv" sowie Tier, Lizenznehmer und License-ID. Die License-ID brauchst du, falls du jemals den Support kontaktierst.

Lifetime plus 1 Jahr Feature-Updates: Deine Lizenz läuft nicht ab. Sicherheitspatches bekommst du dauerhaft gratis, neue Features im aktiven Update-Jahr (verlängerbar). Mehr dazu im Abschnitt Updates.

Erste Schritte: Login und Server verbinden

1. Einloggen: https://panel.deine-domain.de/admin/login mit Benutzername und Passwort aus deiner config.json.
2. DGNCast-Server verbinden: Menü Server → Neuen Server verbinden.
   • Anzeigename: z.B. "Hauptserver"
   • Base-URL: http://127.0.0.1:8000 (wenn DGNCast auf demselben Server läuft) oder http://<server-ip>:8000
   • API-Passwort: aus der config.json deines DGNCast-Servers
3. Verbinden & Test klicken. Erscheint Server erreichbar mit Version und Stream-Anzahl, steht die Verbindung.

Nutze in der Base-URL lieber 127.0.0.1 statt localhost. localhost kann auf IPv6 zeigen und dann scheitert die Verbindung mit "ECONNREFUSED".

Auf der Übersicht siehst du ab jetzt jederzeit den Live-Status: aktuelle Hörer, Streams online und offline, Anzahl Server, Kunden und Pläne.

Standard-Modus: einen Stream betreiben

Im Standard-Modus legst du deine Streams direkt auf dem DGNCast-Server an und verwaltest sie. Die wichtigsten Bausteine:

DJ-Accounts

Jeder DJ, der senden darf, bekommt einen eigenen Account mit Username und Passwort. Unter DJ-Accounts → Neuen DJ anlegen erstellst du sie. Vorteile gegenüber einem geteilten Passwort: Du siehst, wer sendet, und kannst einen einzelnen DJ sperren oder kicken, ohne die anderen zu stören.

AutoDJ und Musik

Im Tab Musik lädst du deine Audio-Dateien hoch (MP3, OGG, FLAC, WAV, M4A, AAC, bis 500 MB pro Datei, einfach in die Dropzone ziehen). AutoDJ spielt diese Playlist automatisch, sobald kein DJ live ist. Mit AutoDJ neu laden übernimmst du Änderungen sofort.

Stream-Einstellungen

Im Tab Einstellungen stellst du Genre, maximale Hörer und die DJ-Crossfade-Dauer ein (wie weich der Server beim Live-Wechsel zwischen zwei DJs überblendet, von hartem Takeover bis 8 Sekunden). Hier schaltest du den Stream auch öffentlich (Player-Seite sichtbar) oder privat.

Player-Seite

Jeder öffentliche Stream hat eine fertige Hörer-Seite mit Web-Player (Play, Lautstärke, "Jetzt läuft", Stream-URLs zum Kopieren und Teilen). Den Link gibst du an deine Hörer weiter.

Reseller-Modus: Kunden hosten

Im Reseller-Tier baust du ein komplettes Radio-Hosting-Geschäft. Der typische Ablauf:

1. Pläne anlegen

Menü Pläne. Ein Plan definiert die Grenzen eines Pakets: maximale Bitrate (kbps), maximale Hörer, Storage (MB) und optional einen Preis pro Monat (nur zur Anzeige). Beispiel: "Basic: 128 kbps, 200 Hörer, 2 GB".

2. Kunden anlegen

Menü Kunden → + Neuer Kunde. Du vergibst Name, E-Mail (das ist der Login), ein Passwort und weist einen Plan zu. Der Kunde kann sich danach auf der Startseite / in sein eigenes Portal einloggen.

3a. Streams zuweisen (manuell)

In der Kunden-Detailseite weist du dem Kunden einen Stream auf deinem DGNCast-Server zu. Der Kunde verwaltet ihn dann im Portal selbst.

3b. Hosting-Instanz auto-provisionieren (empfohlen)

Statt manueller Zuweisung legst du unter Hosting eine komplette eigene DGNCast-Instanz pro Kunde an: eigener Port-Block, eigene Admin-Credentials, automatisch via SSH eingerichtet, in etwa 5 Sekunden. Im Combo-Modus legst du Kunde und Hosting in einem Rutsch an, der Kunde kann sich sofort einloggen. Die Verbindungsdaten für die DJ-Software kannst du per Knopfdruck als E-Mail an den Kunden schicken.

4. Live-Status im Blick

Menü Live-Streams zeigt alle Instanzen und Zuweisungen in Echtzeit (Aktualisierung alle 10 Sekunden): wer online ist, wie viele Hörer wo lauschen, und es warnt, wenn eine Instanz nicht mehr antwortet. Die Moderations-Ansicht erlaubt dir, im Notfall (z.B. DMCA-Verdacht) einzelne oder alle Dateien eines Kunden-Streams zu löschen.

Das Kundenportal

Deine Kunden loggen sich unter / ein und sehen ein aufgeräumtes Portal mit ihren Streams. Pro Stream gibt es vier Tabs: Zugang (Encoder-Verbindungsdaten), Musik (AutoDJ-Upload), Einstellungen und Statistiken. Sie legen ihre eigenen DJ-Accounts an, laden Musik hoch und sehen ihre Hörer-Zahlen, alles unter deinem Branding und deinem Impressum.

Support-Trick: In der Kunden-Detailseite kannst du dich per "Als Kunde einloggen" in das Portal eines Kunden einloggen, um ein Problem aus seiner Sicht zu sehen.

DJs und Encoder verbinden

DGNCast unterstützt zwei Welten. Beide können parallel laufen:

Klassisch: Icecast 2 / Shoutcast

Deine DJs nutzen Standard-Software (Mixxx, VirtualDJ, RadioBoss, BUTT, ...) und verbinden sich mit ihrem DJ-Account (Username + Passwort) oder dem Source-Passwort des Streams. Die nötigen Werte (Server, Port, Mount) stehen im Tab Zugang beziehungsweise in der Zugangsdaten-Mail.

Modern: DGNCast Native Protocol mit API-Keys

Für das DGNCast-eigene Protokoll (z.B. mit dem DGNCast Studio) erzeugst du pro DJ einen API-Key im Tab "API-Keys". Vorteile: Jeder Key ist einzeln sperrbar und rotierbar, ohne andere DJs zu stören. Verknüpfst du einen Key mit einem DJ-Account, zeigen die Statistiken später den DJ-Namen.

Der API-Key wird aus Sicherheitsgründen nur einmal vollständig angezeigt. Kopiere ihn sofort, danach siehst du nur noch eine Vorschau.

Von AzuraCast migrieren

Menü Migration. Der Adapter zieht eine ganze Station automatisiert zu DGNCast um:

1. Quellsystem: Plattform (AzuraCast; Centova Cast ist in Entwicklung), Base-URL und API-Key eintragen. Den API-Key erzeugst du im AzuraCast-Login unter Profil → API-Keys. Verbindung testen klicken.
2. Ziel: Station aus dem Quellsystem wählen, DGNCast-Server und einen Kunde-Slug angeben, Kunde neu anlegen oder bestehenden wählen.
3. Optionen: "DJ-Reset-Mails verschicken" anlassen, dann bekommen alle DJs automatisch einen Link zum Neusetzen ihres Passworts (aus Sicherheitsgründen wird das alte Passwort nicht übernommen).
4. Migration starten. In 1 bis 5 Minuten (je nach Datenmenge) sind Kunde, Hosting-Instanz und AutoDJ-Dateien übertragen, der Stream ist live. Am Ende siehst du einen Report mit den übertragenen Dateien und Zugangsdaten.

Statistiken und Live-Status

Sowohl du als Admin (Übersicht, Live-Streams) als auch deine Kunden (Portal, Tab Statistiken) sehen Hörer-Zahlen: aktuell live, Durchschnitts-Hördauer, letzte 24 Stunden und Gesamt-Werte. So siehst du auf einen Blick, welche Sendung gut läuft.

Impressum und Recht

Bevor das Panel öffentlich erreichbar ist, trägst du unter Einstellungen deine Unternehmens-Daten ein (Firmenname, Anschrift, Kontakt-E-Mail, Steuer-Angaben). Daraus generiert das Panel automatisch ein Impressum (/impressum) und eine Datenschutzerklärung (/datenschutz), wie es § 5 TMG vorschreibt. Hier stellst du auch die Standard-Sprache für neue Kunden ein.

Wenn du das Panel an einen Reseller weitergibst, trägt dieser hier seine eigenen Daten ein, deine erscheinen dann nirgends mehr.

Updates: alles über den Update-Button

Dein Panel aktualisiert sich selbst, kein Hochladen per SFTP nötig.

1. Sobald eine neue Version bereitsteht, erscheint in der Navigation ein roter Punkt am Menüpunkt Updates.
2. Unter Updates siehst du die installierte und die neueste Version sowie den Changelog.
3. Auf Update installieren klicken, das Panel lädt das Update, prüft die Signatur, tauscht sich selbst aus und lädt automatisch neu. Fertig.

Was du bekommst: Sicherheitspatches dauerhaft gratis. Feature-Updates im aktiven Update-Jahr (dein Lizenz-Zeitraum steht auf der Updates-Seite). Läuft das Update-Jahr aus, kannst du es verlängern, das Panel bleibt natürlich weiter nutzbar und sicher.

Sprache umstellen (DE / EN)

Das gesamte Panel und das Kundenportal sind zweisprachig (Deutsch und Englisch). Umgeschaltet wird über den Sprach-Link im Footer. Neue Besucher ohne Account sehen automatisch die Sprache ihres Browsers; als Betreiber legst du unter Einstellungen die Standard-Sprache für neue Kunden fest.

Problem melden und Support

• Direkt aus dem Panel: Menü Problem melden. Deine Meldung geht direkt an unser Team. Passwörter, Schlüssel und Tokens werden vor dem Versand automatisch entfernt.
• Per Mail: support@dgnshop.com. Bei Lizenz-Fragen bitte die License-ID mitschicken (steht unter Lizenz).

Troubleshooting: die häufigsten Stolpersteine

Kurz-Referenz: die Menüpunkte

Admin (du als Betreiber): Übersicht · Server · Pläne* · Kunden* · Hosting* · Live-Streams · Migration · Kontakte · Einstellungen · Updates · Lizenz · Problem melden (* nur im Reseller-Tier)

Kundenportal (dein Endkunde): Meine Streams (Zugang · Musik · Einstellungen · Statistiken) · Konto · Support

DGNCast Streamserver-Panel · © DGN. Alle Rechte vorbehalten. Bei Fragen: support@dgnshop.com