Agente Linux — Instalação

O agente RDS para Linux (versão 2.0 ou superior) transforma um PC com Debian ou Ubuntu num leitor gerido a partir do painel RDS. Arranca sozinho com o equipamento, sem ambiente de trabalho e em ecrã inteiro, em modo quiosque web ou lista de reprodução. É distribuído como pacote .deb.

O agente Linux anterior, escrito em Python (PromoBrowser), foi descontinuado. Veja Agente Python (anterior).

Requisitos

Debian 12 ou 13, ou Ubuntu 22.04 ou 24.04 LTS, de 64 bits (x86_64 / amd64).
ARM64 (beta): Raspberry Pi 4 ou 5 com sistema de 64 bits. Veja ARM64 (beta).
Acesso root (sudo). Não precisa de ambiente de trabalho.
Ligação à internet.

Instalar

Em Descarregamentos → Linux Kiosk Agent prima Transferir .deb.
Na pasta para onde o pacote foi transferido, instale-o com o apt:
```
sudo apt install ./rds-agent_<versão>_amd64.deb
```
O apt instala também todas as dependências do sistema. Use apt, não dpkg -i: o dpkg não resolve dependências e falha a mostrar a lista de pacotes em falta.
O agente fica ativado para arrancar em cada início. Reinicie o equipamento ou arranque-o agora:
```
sudo systemctl start rds-agent
```

Se o equipamento tinha o agente Python (kiosk-browser), a instalação desativa-o para que não disputem o ecrã.

ARM64 (beta)

Existe uma versão do agente Linux para ARM64, pensada para Raspberry Pi 4 e 5 com um sistema de 64 bits (Debian 12 ou posterior, ou Raspberry Pi OS de 64 bits). Está em beta: tem o mesmo conteúdo que a versão x86_64, mas ainda não foi testada em hardware ARM real, e por isso ainda não aparece em Descarregamentos.

Se a quiser experimentar, escreva para support@digitalsignagerds.com e enviamos-lhe o pacote. Instala-se da mesma forma que a versão x86_64:

sudo apt install ./rds-agent_<versão>_arm64.deb

Em equipamentos ARM de 32 bits (armhf) continua a ser necessário o agente Python.

Emparelhar

Ao arrancar, o ecrã mostra Associar este ecrã, com um código QR e um código curto. Leia o QR com o telemóvel (com a sessão do painel aberta), ou abra o endereço indicado e introduza o código. O código renova-se sozinho quando expira. Veja Emparelhar por QR.

Sem QR: no menu de definições do ecrã, separador Servidor, preencha Endereço do servidor, Utilizador e Identificador do dispositivo (RDSXXXX), prima Testar ligação e depois Guardar. Veja Definições no ecrã.

Atualizar

O agente atualiza-se a partir do RDS, sem reinstalar: Painel do dispositivo → Versão do agente. Detalhe. Também pode instalar manualmente um .deb mais recente com o mesmo comando apt install; o emparelhamento mantém-se.

Desinstalar

sudo apt remove rds-agent

Agente Python (anterior)

O agente Python (PromoBrowser) é o agente Linux anterior. Foi descontinuado: não recebe funções novas e tem suporte até 31 de dezembro de 2026. Não inclui o controlo remoto do ecrã, as atualizações a partir do RDS nem o reinício programado; o painel mostra essas funções desativadas num equipamento com este agente.

Num Raspberry Pi 4/5 com sistema de 64 bits pode experimentar o agente ARM64 (beta); o agente Python continua a ser a opção para equipamentos ARM de 32 bits (armhf). Também serve para reinstalar um equipamento que já o usava. Instala-se a partir de Descarregamentos → Raspberry Pi / ARM (agente Python), como root:

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

As suas definições abrem-se escrevendo 12345 ou com 5 toques no canto superior esquerdo (palavra-passe predefinida 0000). O seu serviço é kiosk-browser e o registo, journalctl -u kiosk-browser -f.