Linux agent — Configuration

The Settings dialog opens by typing 12345 or tapping the top-left corner 5 times (in <2 s). It has four tabs: Browser, Server, Log, Security.

Browser

Setting	Description
Mode	Web (kiosk URL) or Playlist (slideshow managed from RDS). Also manageable from the web panel.
Home URL	Page loaded on startup and after blocked navigation (web mode).
Allowlist	Domains allowed for navigation. Any URL outside redirects to Home URL. Managed from the web panel.
Remove Local Videos	Deletes the local cache of playlist videos/images (Playlist mode only).

Server

Setting	Description
Server URL	RDS server base URL. Default `https://rds.digitalsignagerds.com`.
Username	Promotienda username.
Device ID	Identifier assigned in the panel (e.g. `RDSA1B2`).
Test Connection	Verifies credentials and registers the device.
App version	Current agent version (read-only).

Log

Live view of agent logs, auto-refreshes every 3 seconds. These entries are also uploaded to the server on every heartbeat — from the panel they're at Logs → Device logs.

Security

Setting	Description
Passcode	Numeric code to open Settings. Default `0000` — change it in production.
Exit App	Closes the kiosk browser (only useful for maintenance).

Allowlist (whitelist)

The allowlist is evaluated by domain. An entry like example.com:

✓ Allows example.com, www.example.com, cdn.example.com, etc.
✗ Blocks evil.com even if it carries a parameter to example.com.

Any attempt to navigate outside the allowlist redirects to Home URL. target=_blank links are intercepted and opened in the same window (no new windows / tabs allowed).

Sync with the panel

These fields are managed by the web panel (Devices → Edit kiosk) and the agent receives them on its next heartbeat:

Mode (Web / Playlist)
Home URL
Allowlist
Passcode

If you locally change one of these fields, the change is overwritten on the next sync with the server. Change them from the web panel.

SSH access

For maintenance you can SSH into the Linux box:

journalctl -u kiosk-browser -f      # live logs
systemctl restart kiosk-browser     # restart the agent
systemctl stop kiosk-browser        # stop
chvt 7                              # go back to the browser