Installer le boîtier caméra

Le boîtier caméra est la passerelle caméra de votre mosquée : un petit ordinateur sur le même réseau que vos caméras. Il y détecte les caméras NDI et envoie leur image dans le livestream.

Le boîtier se configure sur sa propre page web. Vous l’y connectez à moschee.io et y ajoutez des caméras. Aucune clé API ni variable d’environnement n’est nécessaire.

Ce qu’il vous fautCopy Anchor Link

• Un ordinateur Linux avec Docker, par exemple un mini-PC. Le boîtier ne fonctionne pour l’instant que sur des processeurs x86-64 (Intel ou AMD), pas encore sur un Raspberry Pi.
• Une connexion au même réseau que vos caméras. Un câble réseau est plus fiable que le Wi-Fi.
• Un compte moschee.io avec des droits d’administrateur pour votre mosquée.

InstallationCopy Anchor Link

docker run -d \
  --name kamera-box \
  --network host \
  --restart unless-stopped \
  -v kamera-box-data:/app/data \
  moscheeio/moscheeio-media-gateway-agent:latest

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:

Les caméras sont maintenant disponibles dans la salle de livestreaming. Pour ajouter une caméra à une salle, consultez Diffuser depuis une caméra NDI.

Gérer les boîtiers caméra dans moschee.ioCopy Anchor Link

Dans le tableau de bord, Traduire → Boîtiers caméra liste tous les boîtiers de votre mosquée. Vous y voyez si un boîtier est en ligne, quand il a été actif pour la dernière fois et quelle version il utilise.

En tant qu’administrateur, vous pouvez y renommer un boîtier, par exemple d’après la salle où il se trouve. Retirer déconnecte un boîtier de votre mosquée. Le boîtier s’en aperçoit en moins d’une minute, arrête ses diffusions et affiche de nouveau un code sur sa page de configuration.

En dessous, Caméras liste les caméras PTZ de vos boîtiers avec leurs presets. Vous y réglez la Position de repos et les déplacements aux Heures de prière sans démarrer de salle. Vous enregistrez et renommez les presets dans le pilotage de la caméra d’une salle, car cela demande l’image en direct. Si un boîtier est hors ligne, la page montre ses caméras telles que moschee.io les a vues en dernier. Les propriétaires, administrateurs et streamers voient cette partie. Sous Télécommandes, vous créez des liens avec lesquels l’imam, par exemple, amène les caméras sur leurs préréglages depuis un téléphone, et vous les révoquez (en savoir plus).

Enregistrements sur le boîtier caméraCopy Anchor Link

Le boîtier caméra peut aussi enregistrer vos caméras lui-même, directement sur son disque. Un tel enregistrement continue quand Internet est coupé et ne consomme pas d’heures d’enregistrement. Quand la caméra diffuse dans une salle, le boîtier enregistre aussi le son de la salle : l’original et chaque traduction sur une piste audio séparée.

Espace pour les enregistrementsCopy Anchor Link

Le boîtier range les enregistrements dans le conteneur sous /app/recordings. Pour qu’ils survivent à une mise à jour, donnez-lui un second 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:latest

Avec 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 et stop_grace_period: 30s laissent aux enregistrements en cours le temps de finaliser leurs fichiers quand le boîtier s’arrête ou se met à jour.

Si l’ordinateur a un grand second disque, montez plutôt un dossier de ce disque, par exemple -v /mnt/enregistrements:/app/recordings (avec Docker Compose - /mnt/enregistrements:/app/recordings). Un enregistrement ne démarre qu’avec au moins 5 Go libres. En dessous de 2 Go, le boîtier arrête ses enregistrements.

Démarrer et arrêter un enregistrementCopy Anchor Link

Dans la salle de livestreaming, chaque caméra d’un boîtier caméra a un bouton d’enregistrement avec un choix : Cloud enregistre dans moschee.io, Boîtier caméra sur le boîtier, Les deux lance les deux à la fois. Le bouton retient votre dernier choix. Pendant que le boîtier enregistre, la vignette affiche la durée avec la mention « Boîtier ». Une icône d’avertissement apparaît quand le boîtier signale un problème, par exemple quand la caméra a été coupée un instant.

Si l’option Boîtier caméra n’apparaît pas, le boîtier a besoin d’une mise à jour (voir Mettre à jour le boîtier).

Vous pouvez aussi enregistrer depuis la section Recordings de la page du boîtier. Ces enregistrements apparaissent eux aussi dans moschee.io.

Code PIN des enregistrementsCopy Anchor Link

Les enregistrements montrent les personnes filmées ; un code PIN protège donc la section Recordings de la page du boîtier. Les propriétaires et les administrateurs le définissent dans moschee.io sous Traduire → Boîtiers caméra : 4 à 8 chiffres, ou un code aléatoire. Vous pouvez y afficher ou modifier le code PIN plus tard. Un boîtier en ligne reprend aussitôt le nouveau code ; un boîtier hors ligne, dès qu’il est de nouveau connecté.

Télécharger les enregistrementsCopy Anchor Link

Les fichiers se trouvent sur le boîtier. Depuis le réseau du boîtier, ouvrez http://<adresse IP du boîtier>:8080, allez dans Recordings et saisissez le code PIN. Vous pouvez y télécharger ou supprimer les enregistrements. Le boîtier supprime de lui-même les enregistrements terminés au bout de 30 jours ; ce délai se règle dans la même section.

Sous Boîtiers caméra dans moschee.io, vous voyez pour chaque boîtier s’il peut enregistrer, l’espace libre et ses derniers enregistrements.

Envoyer les enregistrementsCopy Anchor Link

Le boîtier peut aussi envoyer les enregistrements terminés : dans l’espace de stockage de votre mosquée sur moschee.io, sur votre propre stockage (S3, WebDAV, un partage réseau ou SFTP), ou vers Google Drive, OneDrive, Dropbox ou YouTube. Les destinations se configurent dans la section Recordings de la page du boîtier. Les mots de passe et les connexions restent sur le boîtier.

• moschee.io nécessite une offre avec enregistrements. Les enregistrements envoyés comptent dans le stockage de votre offre, pas dans ses heures d’enregistrement, et apparaissent sous Traduire → Enregistrements avec la mention « Boîtier caméra ».
• Sous Boîtiers caméra, vous voyez pour chaque enregistrement où il est envoyé, si l’envoi a réussi et le lien vers le fichier.
• Quand tous les envois d’un enregistrement sont terminés et qu’au moins un a réussi, les propriétaires et les administrateurs reçoivent un e-mail avec les liens.

Déconnecter un boîtier ou le confier à une autre mosquéeCopy Anchor Link

Sur la page de configuration, Disconnect déconnecte le boîtier de moschee.io. Il affiche ensuite un nouveau code qui permet de le reconnecter, y compris à une autre mosquée. Sous Boîtiers caméra dans moschee.io, l’ancienne entrée reste affichée hors ligne jusqu’à ce que vous la retiriez.

Mettre à jour le boîtierCopy Anchor Link

Téléchargez la nouvelle image et recréez le conteneur. La connexion et les caméras restent dans le volume.

docker pull moscheeio/moscheeio-media-gateway-agent:latest
docker stop kamera-box
docker rm kamera-box

Redémarrez ensuite le boîtier avec la même commande docker run que ci-dessus. Avec Docker Compose, docker compose pull && docker compose up -d suffit.

Boîtiers avec clé APICopy Anchor Link

Depuis le 3 novembre 2026, la clé API ne fonctionne plus. Un boîtier configuré avec MOSCHEEIO_API_KEY ne trouve plus sa mosquée après son prochain redémarrage et n’envoie plus de caméras. Après une mise à jour, il dispose lui aussi de la page de configuration. Connectez-y le boîtier à moschee.io pour qu’il apparaisse sous Boîtiers caméra et fonctionne de nouveau. Vous pouvez ensuite retirer la clé de sa configuration.

Ajoutez au passage le volume kamera-box-data:/app/data, sinon la connexion est perdue à la prochaine mise à jour. La page affiche les caméras de GRANDIOSE_EXTRA_IPS ; ajoutez les nouvelles caméras directement sur la page.

Les boîtiers qui utilisent encore l’image ghcr.io/ihsandigital/moscheeio-ndi-client ou moscheeio/moscheeio-ndi-client ne reçoivent plus de mises à jour. Passez-les à moscheeio/moscheeio-media-gateway-agent comme décrit plus haut dans Mettre à jour le boîtier.

DépannageCopy Anchor Link

Étapes suivantesCopy Anchor Link