Agent Linux — Installation

L'agent RDS pour Linux (version 2.0 ou supérieure) transforme un PC sous Debian ou Ubuntu en lecteur géré depuis le panneau RDS. Il démarre avec la machine, sans bureau et en plein écran, en mode kiosque web ou liste de lecture. Il est distribué sous forme de paquet .deb.

L'ancien agent Linux, écrit en Python (PromoBrowser), est abandonné. Voir Agent Python (ancien).

Prérequis

Debian 12 ou 13, ou Ubuntu 22.04 ou 24.04 LTS, en 64 bits (x86_64 / amd64).
ARM64 (bêta) : Raspberry Pi 4 ou 5 avec un système 64 bits. Voir ARM64 (bêta).
Accès root (sudo). Aucun environnement de bureau nécessaire.
Une connexion internet.

Installer

Dans Téléchargements → Agent kiosque Linux, appuyez sur Télécharger .deb.
Depuis le dossier où le paquet a été téléchargé, installez-le avec apt :
```
sudo apt install ./rds-agent_<version>_amd64.deb
```
apt installe aussi toutes les dépendances système. Utilisez apt, pas dpkg -i : dpkg ne résout pas les dépendances et échoue en affichant la liste des paquets manquants.
L'agent est activé pour démarrer à chaque démarrage. Redémarrez la machine, ou lancez-le maintenant :
```
sudo systemctl start rds-agent
```

Si la machine avait l'agent Python (kiosk-browser), l'installation le désactive pour qu'ils ne se disputent pas l'écran.

ARM64 (bêta)

Il existe une version de l'agent Linux pour ARM64, prévue pour les Raspberry Pi 4 et 5 sous un système 64 bits (Debian 12 ou supérieur, ou Raspberry Pi OS 64 bits). Elle est en bêta : elle a le même contenu que la version x86_64, mais elle n'a pas encore été testée sur du vrai matériel ARM, c'est pourquoi elle n'apparaît pas encore dans Téléchargements.

Si vous voulez l'essayer, écrivez à support@digitalsignagerds.com et nous vous enverrons le paquet. Elle s'installe comme la version x86_64 :

sudo apt install ./rds-agent_<version>_arm64.deb

Sur les appareils ARM 32 bits (armhf), l'agent Python reste nécessaire.

Appairer

Au démarrage, l'écran affiche Associer cet écran, avec un code QR et un code court. Scannez le QR avec votre téléphone (connecté au panneau), ou ouvrez l'adresse indiquée et saisissez le code. Le code se renouvelle tout seul à expiration. Voir Appairer par QR.

Sans QR : dans le menu de réglages de l'écran, onglet Serveur, remplissez Adresse du serveur, Utilisateur et Identifiant de l'appareil (RDSXXXX), appuyez sur Tester la connexion puis sur Enregistrer. Voir Réglages sur l'écran.

Mettre à jour

L'agent se met à jour depuis RDS, sans réinstallation : Panneau de l'appareil → Version de l'agent. Détail. Vous pouvez aussi installer à la main un .deb plus récent avec la même commande apt install ; l'appairage est conservé.

Désinstaller

sudo apt remove rds-agent

Agent Python (ancien)

L'agent Python (PromoBrowser) est l'ancien agent Linux. Il est abandonné : il ne reçoit plus de nouvelles fonctions et il est pris en charge jusqu'au 31 décembre 2026. Il n'inclut ni le contrôle à distance de l'affichage, ni les mises à jour depuis RDS, ni le redémarrage programmé ; le panneau affiche ces fonctions désactivées sur une machine qui l'utilise.

Sur un Raspberry Pi 4/5 avec un système 64 bits, vous pouvez essayer l'agent ARM64 (bêta) ; l'agent Python reste l'option pour les appareils ARM 32 bits (armhf). Il sert aussi à réinstaller une machine qui l'utilisait déjà. Il s'installe depuis Téléchargements → Raspberry Pi / ARM (agent Python), en root :

curl -fsSL https://rds.digitalsignagerds.com/install.sh | bash
systemctl start kiosk-browser

Ses réglages s'ouvrent en tapant 12345 ou avec 5 appuis dans le coin supérieur gauche (mot de passe par défaut 0000). Son service est kiosk-browser et son journal, journalctl -u kiosk-browser -f.