Téléchargements et installation

Quelle forme pour quel écran

Le serveur est commun à tout le parc. Le kiosque dépend de l'écran.

Écran	Forme	Pourquoi
Windows IdeaHub, module OPS	Exécutable autonome .exe	Lui seul porte la coque plein écran, un profil de navigateur par fournisseur de visioconférence et le lancement verrouillé des réunions.
Linux	Conteneur Docker	L'interface est servie à un navigateur en mode kiosque.
Android, HarmonyOS	Clients natifs	Prévus après la version 1.0.

Client Windows

Installeur autonome. Ni Docker, ni Node.js à installer sur l'écran.

La 1.0.6 met à jour l'écran, et pas seulement le serveur. Les 1.0.4 et 1.0.5 ne touchaient qu'au serveur ; celle-ci corrige deux défauts du client Windows qui empêchaient purement et simplement un écran de joindre un serveur chiffré dans certaines configurations. Un parc en 1.0.3 doit être mis à jour — voir le journal des versions.

Vérifier l'empreinte avant d'installer

Get-FileHash .\Kelra-Room-Setup-1.0.6.exe -Algorithm SHA256

La valeur affichée doit correspondre exactement à celle ci-dessus. Si elle diffère, le fichier a été altéré ou le téléchargement est incomplet : ne pas l'exécuter.

L'installation se fait pour toute la machine et demande une élévation : en salle, l'écran tourne souvent sous un compte dédié, distinct de celui du technicien qui installe. Les données de l'écran — adresse du serveur, appairage, fond d'écran, sessions des comptes de salle — survivent à une désinstallation ou à une mise à jour.

Serveur

Linux, Docker. Aucune compilation, aucun code source nécessaire.

Créer un dossier et y déposer ce fichier. Un seul suffit : toutes les variables ont une valeur par défaut.

docker-compose.yml

services:
  server:
    image: ghcr.io/kelralabs/kelra-room-server:1.0.6
    restart: unless-stopped
    ports:
      - "4001:4000"
    volumes:
      - openroom-data:/app/data
    environment:
      PORT: "4000"
      DB_PATH: /app/data/openroom.db
      ADMIN_SECRET: ${ADMIN_SECRET:-changeme}
      NODE_ENV: production
      TZ: ${TZ:-Europe/Paris}
      BROKER_MIRROR: ${BROKER_MIRROR:-1}
      BROKER_POLL_MS: ${BROKER_POLL_MS:-60000}

volumes:
  openroom-data:

.env — facultatif

À créer uniquement si vous voulez changer une de ces valeurs. Sans ce fichier, les défauts s'appliquent et l'installation fonctionne.

# Active l'en-tete d'administration en ligne de commande — voir la note.
# ADMIN_SECRET=un-secret-long-et-aleatoire

# Fuseau du site, si ce n'est pas Europe/Paris.
# TZ=Europe/Brussels

# Arret d'urgence des miroirs d'occupation du broker.
# BROKER_MIRROR=0

Démarrer

docker compose pull
docker compose up -d server

Se connecter

La console d'administration répond sur http://<serveur>:4001/admin. Le compte initial est admin / admin, et le serveur impose le changement du mot de passe à la première connexion : tant qu'il n'est pas fait, le reste de l'administration reste inaccessible.

Les administrateurs suivants se créent dans la console, nominativement — un compte par personne plutôt qu'un mot de passe partagé.

Chiffrer les échanges (TLS)

Les exemples ci-dessus sont en http pour aller au plus court sur un premier essai. En production, Kelra Room se sert en HTTPS, de trois façons au choix :

• Le serveur s'en charge — deux lignes dans .env, et il génère sa propre autorité et son certificat au premier démarrage. Aucun composant supplémentaire, aucun nom de domaine, aucune démarche extérieure. Les écrans Windows adoptent l'autorité à la première rencontre.
• Certificat d'entreprise — le vôtre, monté en volume, quand la DSI dispose déjà d'une autorité interne.
• Certificat automatique via Caddy avec un nom de domaine résolvable, ou via Tailscale sans domaine public.

TLS_SELF_SIGNED=1
TLS_NAMES=192.168.1.10,serveur.interne,localhost,127.0.0.1

Le serveur s'y adapte seul : le cookie de session est marqué Secure dès que la connexion est chiffrée, y compris derrière un proxy. La procédure complète figure dans la documentation, section « Chiffrer les échanges ».

Écran Linux : ajouter le kiosque

  kiosk:
    image: ghcr.io/kelralabs/kelra-room-kiosk:1.0.6
    restart: unless-stopped
    ports:
      - "3001:3000"
    environment:
      NODE_ENV: production
      OPENROOM_SERVER_URL: http://<serveur>:4001

OPENROOM_SERVER_URL doit être l'adresse joignable depuis le navigateur de l'écran, et non depuis l'intérieur de Docker. Laissée vide, le kiosque affiche son écran de premier lancement et demande l'adresse à l'écran.

Mettre à jour

La version est figée dans le fichier, jamais suivie automatiquement : un pull ne doit pas changer la version d'un produit en production sans décision. Modifier l'étiquette, puis :

docker compose pull server
docker compose up -d server

Licence

Kelra Room est distribué sous Business Source License 1.1. Le code source est fourni et auditable, chaque déploiement tourne entièrement sur votre infrastructure — mais ce n'est pas une licence open source.

Chaque déploiement dispose d'une période d'évaluation de trente jours, après laquelle une clé est nécessaire pour que les écrans continuent d'être servis. La console d'administration, elle, reste accessible : c'est par elle qu'on saisit la clé.

Licences et questions commerciales : hello@kelralabs.com. Support et dépannage : helpdesk@kelralabs.com.