Agente Linux — Installazione

L'agente RDS per Linux (versione 2.0 o superiore) trasforma un PC con Debian o Ubuntu in un player gestito dal pannello RDS. Si avvia da solo con il computer, senza desktop e a schermo intero, in modalità kiosk web o playlist. Viene distribuito come pacchetto .deb.

Il precedente agente Linux, scritto in Python (PromoBrowser), è stato dismesso. Veda Agente Python (precedente).

Requisiti

Debian 12 o 13, oppure Ubuntu 22.04 o 24.04 LTS, a 64 bit (x86_64 / amd64).
ARM64 (beta): Raspberry Pi 4 o 5 con sistema a 64 bit. Veda ARM64 (beta).
Accesso root (sudo). Non serve un ambiente desktop.
Connessione a internet.

Installare

In Download → Linux Kiosk Agent prema Scarica .deb.
Dalla cartella in cui è stato scaricato il pacchetto, lo installi con apt:
```
sudo apt install ./rds-agent_<versione>_amd64.deb
```
apt installa anche tutte le dipendenze di sistema. Usi apt, non dpkg -i: dpkg non risolve le dipendenze e fallisce mostrando l'elenco dei pacchetti mancanti.
L'agente resta abilitato ad avviarsi a ogni accensione. Riavvii il computer o lo avvii subito:
```
sudo systemctl start rds-agent
```

Se il computer aveva l'agente Python (kiosk-browser), l'installazione lo disattiva perché non si contendano lo schermo.

ARM64 (beta)

Esiste una versione dell'agente Linux per ARM64, pensata per Raspberry Pi 4 e 5 con un sistema a 64 bit (Debian 12 o successivo, oppure Raspberry Pi OS a 64 bit). È in beta: ha lo stesso contenuto della versione x86_64, ma non è ancora stata provata su hardware ARM reale, ed è per questo che non compare ancora in Download.

Se vuole provarla, scriva a support@digitalsignagerds.com e le invieremo il pacchetto. Si installa come la versione x86_64:

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

Sui dispositivi ARM a 32 bit (armhf) resta necessario l'agente Python.

Associare

All'avvio lo schermo mostra Collega questo schermo, con un codice QR e un codice breve. Scansioni il QR con il telefono (con la sessione del pannello aperta), oppure apra l'indirizzo indicato e inserisca il codice. Il codice si rinnova da solo quando scade. Veda Associare tramite QR.

Senza QR: nel menu delle impostazioni dello schermo, scheda Server, compili Indirizzo del server, Utente e Identificatore del dispositivo (RDSXXXX), prema Prova connessione e poi Salva. Veda Impostazioni sullo schermo.

Aggiornare

L'agente si aggiorna da RDS, senza reinstallare: Pannello del dispositivo → Versione dell'agente. Dettagli. Può anche installare a mano un .deb più recente con lo stesso comando apt install; l'associazione viene mantenuta.

Disinstallare

sudo apt remove rds-agent

Agente Python (precedente)

L'agente Python (PromoBrowser) è il precedente agente Linux. È stato dismesso: non riceve nuove funzioni ed è supportato fino al 31 dicembre 2026. Non include il controllo remoto dello schermo, gli aggiornamenti da RDS né il riavvio programmato; il pannello mostra queste funzioni disattivate su un computer con questo agente.

Su un Raspberry Pi 4/5 con sistema a 64 bit può provare l'agente ARM64 (beta); l'agente Python resta l'opzione per i dispositivi ARM a 32 bit (armhf). Serve anche a reinstallare un computer che lo usava già. Si installa da Download → Raspberry Pi / ARM (agente Python), come root:

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

Le sue impostazioni si aprono digitando 12345 o con 5 tocchi nell'angolo in alto a sinistra (password predefinita 0000). Il suo servizio è kiosk-browser e il suo registro journalctl -u kiosk-browser -f.