Kamera-Box einrichten
Die Kamera-Box installieren, auf ihrer Einrichtungsseite mit moschee.io verbinden und Kameras hinzufügen.
Die Kamera-Box ist das Kamera-Gateway Ihrer Moschee: ein kleiner Computer im selben Netzwerk wie Ihre Kameras. Sie findet die NDI-Kameras dort und sendet ihr Bild in den Livestream.
Eingerichtet wird die Box auf ihrer eigenen Webseite. Dort verbinden Sie sie mit moschee.io und tragen Kameras ein. Einen API-Schlüssel oder Umgebungsvariablen brauchen Sie dafür nicht.
Plan
Kamera-Boxen sind ab dem Plan Gemeinde Plus verfügbar.
Was Sie brauchen
- Einen Linux-Computer mit Docker, zum Beispiel einen Mini-PC. Die Box läuft derzeit nur auf x86-64-Prozessoren (Intel oder AMD), noch nicht auf einem Raspberry Pi.
- Eine Netzwerkverbindung zum selben Netzwerk wie Ihre Kameras. Ein Netzwerkkabel ist zuverlässiger als WLAN.
- Ein moschee.io-Konto mit Admin-Rechten für Ihre Moschee.
Einrichtung
Kamera-Box starten
Starten Sie die Box auf dem Computer mit diesem Befehl:
docker run -d \
--name kamera-box \
--network host \
--restart unless-stopped \
-v kamera-box-data:/app/data \
moscheeio/moscheeio-media-gateway-agent:latest--network host ist nötig, damit die Box die Kameras im Netzwerk findet. Im Volume kamera-box-data speichert die Box ihre Verbindung zu moschee.io und Ihre Kameras, auch über Updates hinweg.
Mit Docker Compose sieht dieselbe Box so aus:
services:
kamera-box:
image: moscheeio/moscheeio-media-gateway-agent:latest
container_name: kamera-box
network_mode: host
restart: unless-stopped
volumes:
- kamera-box-data:/app/data
volumes:
kamera-box-data:Starten Sie sie mit docker compose up -d.
Einrichtungsseite öffnen
Öffnen Sie auf einem Computer oder Handy im selben Netzwerk die Adresse http://<IP-Adresse der Box>:8080. Die Box schreibt die Adresse auch in ihr Protokoll: docker logs kamera-box zeigt eine Zeile wie Setup page: http://192.168.1.20:8080/.
Die Seite zeigt oben den Status der Box und unten die Kameras, die sie im Netzwerk gefunden hat.
Mit moschee.io verbinden
Klicken Sie auf Mit moschee.io verbinden. Die Box zeigt einen Code.
Klicken Sie auf In moschee.io bestätigen und melden Sie sich an. Prüfen Sie, dass dort derselbe Code steht und als Gerätetyp Kamera-Box genannt ist. Wählen Sie Ihre Moschee und klicken Sie auf Verbinden.
Sie können den Code auch auf einem anderen Gerät bestätigen: Öffnen Sie dort https://app.moschee.io/device und geben Sie den Code ein. Läuft ein Code ab, zeigt die Box von selbst einen neuen.
Verbindung prüfen
Die Einrichtungsseite merkt die Bestätigung von selbst. Danach steht dort Ihre Moschee, und der Kamera-Server ist verbunden.
Kameras prüfen
NDI-Kameras im selben Netz findet die Box von selbst. Sie stehen unter Im Netzwerk gefunden, jeweils mit ihrem Format: NDI|HX · H.264 oder NDI · SpeedHQ.
Liegt eine Kamera in einem anderen Netz, zum Beispiel einem eigenen VLAN, tragen Sie unter Kameras in anderen Netzen ihre IP-Adresse oder ihren Namen ein und klicken auf Hinzufügen. Die Box sucht dann auch dort. Mit Entfernen nehmen Sie einen Eintrag wieder heraus.
Die Kameras stehen jetzt im Livestreaming-Raum zur Auswahl. Wie Sie eine Kamera in einen Raum holen, lesen Sie unter NDI-Kamera streamen.
Kamera-Boxen in moschee.io verwalten
Im Dashboard finden Sie unter Übersetzung → Kamera-Boxen alle Boxen Ihrer Moschee. Dort sehen Sie, ob eine Box online ist, wann sie zuletzt aktiv war und welche Version sie hat.
Als Admin können Sie dort eine Box umbenennen, zum Beispiel nach dem Raum, in dem sie steht. Mit Entfernen trennen Sie eine Box von Ihrer Moschee. Sie bemerkt das innerhalb einer Minute, beendet ihre Übertragungen und zeigt auf der Einrichtungsseite wieder einen Code.
Darunter stehen unter Kameras die PTZ-Kameras Ihrer Boxen mit ihren Presets. Dort stellen Sie die Ruheposition und die Bewegungen zu den Gebetszeiten ein, ohne einen Raum zu starten. Presets speichern und umbenennen Sie in der Kamera-Steuerung eines Raums, weil das das Live-Bild braucht. Ist eine Box offline, zeigt die Seite ihre Kameras so, wie moschee.io sie zuletzt gesehen hat. Den Bereich sehen Inhaber, Admins und Streamer. Unter Fernbedienungen erstellen Sie Links, mit denen zum Beispiel der Imam die Kameras vom Handy aus auf ihre Presets fährt, und widerrufen sie wieder (mehr dazu).
Aufnahmen auf der Kamera-Box
Die Kamera-Box kann Ihre Kameras auch selbst aufnehmen, direkt auf ihre Festplatte. Eine solche Aufnahme läuft weiter, wenn das Internet ausfällt, und verbraucht keine Aufnahmestunden. Streamt die Kamera in einen Raum, nimmt die Box den Ton aus dem Raum mit auf: das Original und jede Übersetzung als eigene Tonspur.
Speicherplatz für Aufnahmen
Die Box speichert Aufnahmen im Container unter /app/recordings. Damit sie ein Update überstehen, braucht die Box dafür ein zweites Volume:
docker run -d \
--name kamera-box \
--network host \
--restart unless-stopped \
--stop-timeout 30 \
-v kamera-box-data:/app/data \
-v kamera-box-recordings:/app/recordings \
moscheeio/moscheeio-media-gateway-agent:latestMit Docker Compose:
services:
kamera-box:
image: moscheeio/moscheeio-media-gateway-agent:latest
container_name: kamera-box
network_mode: host
restart: unless-stopped
stop_grace_period: 30s
volumes:
- kamera-box-data:/app/data
- kamera-box-recordings:/app/recordings
volumes:
kamera-box-data:
kamera-box-recordings:--stop-timeout 30 und stop_grace_period: 30s geben laufenden Aufnahmen beim Stoppen und bei einem Update Zeit, ihre Dateien abzuschließen.
Hat der Computer eine große zweite Festplatte, binden Sie stattdessen einen Ordner darauf ein, zum Beispiel -v /mnt/aufnahmen:/app/recordings (mit Docker Compose - /mnt/aufnahmen:/app/recordings). Eine Aufnahme startet nur mit mindestens 5 GB freiem Speicher. Fällt er unter 2 GB, beendet die Box ihre Aufnahmen.
Aufnahme starten und stoppen
Im Livestreaming-Raum hat jede Kamera einer Kamera-Box einen Aufnahmeknopf mit Auswahl: Cloud speichert die Aufnahme in moschee.io, Kamera-Box auf der Box, Beides startet beide zugleich. Der Knopf merkt sich Ihre letzte Wahl. Während die Box aufnimmt, zeigt die Kachel die Dauer mit dem Hinweis „Box“. Ein Warnsymbol erscheint, wenn die Box ein Problem meldet, zum Beispiel wenn die Kamera kurz weg war.
Fehlt die Option Kamera-Box, braucht die Box ein Update (siehe Box aktualisieren).
Sie können auch auf der Seite der Box im Bereich Aufnahmen aufnehmen. Diese Aufnahmen erscheinen ebenfalls in moschee.io.
Aufnahme-PIN
Aufnahmen zeigen, wer vor der Kamera war. Deshalb schützt eine PIN den Bereich Aufnahmen auf der Seite der Box. Inhaber und Admins legen sie in moschee.io unter Übersetzung → Kamera-Boxen fest: 4 bis 8 Ziffern oder eine zufällige PIN. Dort können Sie die PIN auch wieder anzeigen oder ändern. Eine Box, die online ist, übernimmt die neue PIN sofort, eine Box, die offline ist, sobald sie wieder verbunden ist.
Aufnahmen herunterladen
Die Dateien liegen auf der Box. Öffnen Sie im Netzwerk der Box http://<IP-Adresse der Box>:8080, gehen Sie zu Aufnahmen und geben Sie die PIN ein. Dort laden Sie Aufnahmen herunter oder löschen sie. Fertige Aufnahmen löscht die Box nach 30 Tagen von selbst; die Frist stellen Sie im selben Bereich ein.
Unter Kamera-Boxen in moschee.io sehen Sie für jede Box, ob sie aufnehmen kann, wie viel Speicher frei ist und welche Aufnahmen sie zuletzt gemacht hat.
Aufnahmen hochladen
Die Box kann fertige Aufnahmen auch hochladen: in den Speicher Ihrer Moschee bei moschee.io, auf einen eigenen Speicher (S3, WebDAV, eine Netzwerkfreigabe oder SFTP), zu Google Drive, OneDrive, Dropbox oder YouTube. Die Ziele richten Sie auf der Seite der Box im Bereich Aufnahmen ein. Passwörter und Anmeldungen bleiben auf der Box.
- moschee.io braucht einen Plan mit Aufzeichnungen. Hochgeladene Aufnahmen zählen zum Speicher Ihres Plans, nicht zu den Aufnahmestunden, und erscheinen unter Übersetzung → Aufzeichnungen mit dem Hinweis „Kamera-Box“.
- Unter Kamera-Boxen sehen Sie bei jeder Aufnahme, wohin sie hochgeladen wird, ob es geklappt hat, und den Link zur Datei.
- Sind alle Uploads einer Aufnahme beendet und hat mindestens einer geklappt, bekommen Inhaber und Admins eine E-Mail mit den Links.
Box trennen oder einer anderen Moschee geben
Auf der Einrichtungsseite trennt Verbindung trennen die Box von moschee.io. Danach zeigt sie einen neuen Code, mit dem Sie sie wieder verbinden können, auch mit einer anderen Moschee. Unter Kamera-Boxen in moschee.io bleibt der alte Eintrag als offline stehen, bis Sie ihn dort entfernen.
Box aktualisieren
Laden Sie das neue Image und erstellen Sie den Container neu. Verbindung und Kameras bleiben im Volume erhalten.
docker pull moscheeio/moscheeio-media-gateway-agent:latest
docker stop kamera-box
docker rm kamera-boxStarten Sie die Box danach mit demselben docker run-Befehl wie oben. Mit Docker Compose genügt docker compose pull && docker compose up -d.
Boxen mit API-Schlüssel
Seit dem 3. November 2026 funktioniert der API-Schlüssel nicht mehr. Eine Box, die mit MOSCHEEIO_API_KEY eingerichtet wurde, findet ihre Moschee nach dem nächsten Neustart nicht mehr und sendet keine Kameras mehr. Nach einem Update hat auch sie die Einrichtungsseite. Verbinden Sie die Box dort mit moschee.io, damit sie unter Kamera-Boxen erscheint und wieder läuft. Danach können Sie den Schlüssel aus der Konfiguration entfernen.
Fügen Sie dabei das Volume kamera-box-data:/app/data hinzu, sonst geht die Verbindung beim nächsten Update verloren. Kameras aus GRANDIOSE_EXTRA_IPS zeigt die Seite an; neue Kameras tragen Sie direkt auf der Seite ein.
Boxen, die noch mit dem Image ghcr.io/ihsandigital/moscheeio-ndi-client oder moscheeio/moscheeio-ndi-client laufen, bekommen keine Updates mehr. Stellen Sie sie auf moscheeio/moscheeio-media-gateway-agent um, wie oben unter Box aktualisieren beschrieben.