Supra Server

This article covers everything about the Supra Server: hardware prerequisites, provisioning, installation, and ongoing management through Box.

Prerequisites

Requirement	Detail
Operating System	Ubuntu 24.04 (mandatory)
Linux user (UID 1000)	The supra-server-daemon must be installed under the user with UID 1000.
Graphical session	The UID 1000 user must have an active graphical session (display server running).
Feature entitlement	The organization must have the Supra On-Premise feature entitlement enabled. Contact your signageOS account manager to enable it.
Custom Scripts	The device must report CUSTOM_SCRIPTS in its management capabilities.

info

Cloud Control mode (without frontend) is recommended for the Supra Server device. Running a full Core App with frontend on the Supra Server may cause unexpected side effects — see Known Limitations.

Step 1: Provision the Ubuntu Device

The Ubuntu device must be provisioned with the signageOS Cloud Control app before it can be managed from Box.

Run the following commands on the Ubuntu device:

wget https://linux-package-repository.signageos.io/linux/install.sh
chmod +x install.sh
sudo ./install.sh provision --ORGANIZATION_UID --disable-frontend

After provisioning, the device will appear in Box and can be managed remotely.

tip

For more details on Ubuntu provisioning, see the Ubuntu provisioning documentation.

Step 2: Assign a Location

1. In Box, create or select a Location for your Supra deployment.
2. Navigate to the provisioned Ubuntu device and assign it to the Location.
3. All client devices that should use this Supra Server must be assigned to the same Location.

Step 3: Install Supra Server

Once the device is provisioned and assigned to a Location:

1. Navigate to the device detail page in Box.
2. Open the Supra tab.
3. Click Install Supra.
4. Monitor the script output — it will install supra-server-daemon and all required dependencies.

The installation script is idempotent — running it again will upgrade or downgrade the Supra Server to the latest version.

info

The Supra tab is only visible when all prerequisites are met. If you don't see the tab, verify the prerequisites above.

Step 4: Verify Installation

After installation completes:

1. The Status section in the Supra tab should show Installed.
2. The Connected Clients table will list all devices in the same Location.
3. You can now enable Supra mode on client devices.

Upgrading or Downgrading

Click Install Supra again from the Supra tab. The install script is idempotent and will update to the latest available version.

Uninstalling

1. Navigate to the device's Supra tab.
2. Click Uninstall Supra.

This removes the supra-server-daemon package and related components from the device.

Supra Tab Reference

Navigate to Device Detail → Supra to access the management interface. The tab contains the following sections:

Info Box

An informational banner with a brief description of Supra and a link to the full documentation.

Status

• Installed — the supra-server-daemon package is detected in the device's installed-packages telemetry.
• Not Installed — the package has not been detected yet.

Location

Shows the Location assigned to the device (name, custom ID, address). If no Location is assigned, a warning is displayed.

Actions

Action	Custom Script	Available When
Install Supra	supra-server-install-server	Supra is not installed
Uninstall Supra	supra-server-uninstall-server	Supra is installed
Restart Server	supra-server-restart-server	Supra is installed
Restart Screens	supra-server-restart-screens	Supra is installed

Connected Clients

A table listing every device in the same Location (excluding the Supra Server itself):

Column	Description
Platform	Device platform icon (Tizen, Android, Linux, etc.)
Name	Device name with a link to the device detail page
Applet	Name of the applet in the client's active timing
Applet Version	Version of the active applet
Status	Whether Supra mode is active (supra: enabled in timing configuration)
Action	A Refresh button that sends an APPLET_REFRESH power action to the client device

Client Count

A summary card showing the number of clients with Supra mode enabled versus total client devices in the Location.

Monitoring

The Supra Server monitoring (Grafana-based) can be installed using the supra-server-install-monitoring Custom Script and accessed at http://<supra-server-ip>:3000. See Monitoring for details.

Custom Scripts Reference

The following Custom Scripts are automatically provisioned when the Supra On-Premise feature entitlement is enabled:

Script	Description
Supra Server - install-server	Installs supra-server-daemon and all required dependencies. Main installation script.
Supra Server - install-monitoring	Installs the Grafana-based monitoring stack. See Monitoring.
Supra Server - update-clients	Updates Supra client components on connected devices.
Supra Server - restart-server	Restarts the Supra Server daemon.
Supra Server - kill-screens	Kills all screen sessions on the Supra Server. Useful for troubleshooting.
Supra Server - uninstall-server	Removes the Supra Server from the device.

info

These scripts can also be executed from the Scripts section on the device page if preferred over the Supra tab buttons.

Related Topics

• Supra Overview — General introduction to Supra
• Supra Client Management — Enabling and managing Supra mode on client devices
• TLS Setup — Enabling secure connections
• Known Limitations — Current limitations and workarounds