Agente Linux — Instalación

El agente RDS para Linux (versión 2.0 o superior) convierte un PC con Debian o Ubuntu en un reproductor gestionado desde el panel RDS. Arranca solo con el equipo, sin escritorio y a pantalla completa, en modo kiosco web o lista de reproducción. Se distribuye como paquete .deb.

El agente Linux anterior, escrito en Python (PromoBrowser), está descontinuado. Ver Agente Python (anterior).

Requisitos

Debian 12 o 13, o Ubuntu 22.04 o 24.04 LTS, de 64 bits (x86_64 / amd64).
ARM64 (beta): Raspberry Pi 4 o 5 con sistema de 64 bits. Ver ARM64 (beta).
Acceso root (sudo). No necesita entorno de escritorio.
Conexión a internet.

Instalar

En Downloads → Linux Kiosk Agent pulsa Descargar .deb.
Desde la carpeta donde se descargó el paquete, instálalo con apt:
```
sudo apt install ./rds-agent_<versión>_amd64.deb
```
apt instala también todas las dependencias del sistema. Usa apt, no dpkg -i: dpkg no resuelve dependencias y falla mostrando la lista de paquetes que faltan.
El agente queda habilitado para arrancar en cada inicio. Reinicia el equipo o arráncalo ahora:
```
sudo systemctl start rds-agent
```

Si el equipo tenía el agente Python (kiosk-browser), la instalación lo desactiva para que no compitan por la pantalla.

ARM64 (beta)

Hay una versión del agente Linux para ARM64, pensada para Raspberry Pi 4 y 5 con un sistema de 64 bits (Debian 12 o posterior, o Raspberry Pi OS de 64 bits). Está en beta: tiene el mismo contenido que la versión x86_64, pero todavía no se ha probado en hardware ARM real, y por eso aún no aparece en Downloads.

Si quieres probarla, escríbenos a support@digitalsignagerds.com y te enviaremos el paquete. Se instala igual que la versión x86_64:

sudo apt install ./rds-agent_<versión>_arm64.deb

En equipos ARM de 32 bits (armhf) sigue siendo necesario el agente Python.

Emparejar

Al arrancar, la pantalla muestra Vincular esta pantalla, con un código QR y un código corto. Escanea el QR con el móvil (con la sesión del panel abierta), o abre la dirección que se indica e introduce el código. El código se renueva solo cuando caduca. Ver Emparejar por QR.

Sin QR: en el menú de ajustes de la pantalla, pestaña Servidor, rellena Dirección del servidor, Usuario e Identificador del dispositivo (RDSXXXX), pulsa Probar conexión y después Guardar. Ver Ajustes en la pantalla.

Actualizar

El agente se actualiza desde RDS, sin volver a instalar: Panel del dispositivo → Versión del agente. Detalle. También puedes instalar a mano un .deb más reciente con el mismo comando apt install; el emparejamiento se conserva.

Desinstalar

sudo apt remove rds-agent

Agente Python (anterior)

El agente Python (PromoBrowser) es el agente Linux anterior. Está descontinuado: no recibe funciones nuevas y tiene soporte hasta el 31 de diciembre de 2026. No incluye el control remoto de la pantalla, las actualizaciones desde RDS ni el reinicio programado; el panel muestra esas funciones desactivadas en un equipo con este agente.

En Raspberry Pi 4/5 con sistema de 64 bits puedes probar el agente ARM64 (beta); el agente Python sigue siendo la opción para equipos ARM de 32 bits (armhf). También sirve para reinstalar un equipo que ya lo usaba. Se instala desde Downloads → Raspberry Pi / ARM (agente Python), como root:

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

Sus ajustes se abren tecleando 12345 o con 5 toques en la esquina superior izquierda (contraseña por defecto 0000). Su servicio es kiosk-browser y su registro, journalctl -u kiosk-browser -f.