Pairing a Device
Pairing a device is the process of connecting a physical screen’s player software to your Stratos account. This article walks you through the setup from installation to authorization.
Prerequisites
Section titled “Prerequisites”Before pairing, ensure:
- The player device is connected to your network.
- The player can reach your Stratos URL over the network.
- You have a Stratos account with permission to authorize screens.
Step 1: Install the Player Software
Section titled “Step 1: Install the Player Software”Install the Stratos player software on the device. The player is available for:
- Windows — installer package (.exe).
- Linux — package for Debian/Ubuntu (.deb) and RHEL/CentOS (.rpm).
- Raspberry Pi — Raspberry Pi OS image.
- Android — APK file.
Download the appropriate package from your Stratos account or contact support for the latest version.
Step 2: Configure the Player
Section titled “Step 2: Configure the Player”After installation, configure the player to point at your Stratos instance:
- Open the player configuration (usually at
http://localhost:8080/configon the device). - Enter your Stratos URL (e.g.,
https://stratos.stratos.com). - Optionally enter a device name — this helps you identify the screen later.
- Save the configuration.
The player attempts to connect to Stratos immediately.
Step 3: Authorize the Device
Section titled “Step 3: Authorize the Device”- Go to Screens → Screens in Stratos.
- The new device appears in the Pending Authorization callout at the top of the page.
- Click Authorize on the device row.
- (Recommended) Click Edit Display to set a clear name, time zone, and default layout.
The device becomes active immediately and starts playing its default layout or assigned schedule.
Step 4: Verify
Section titled “Step 4: Verify”- Check that the device shows as Online (green) on the Screens page.
- Use Request Screenshot to verify the correct content is playing.
- Confirm the time zone is set correctly — this affects schedule evaluation.
Troubleshooting
Section titled “Troubleshooting”| Issue | Solution |
|---|---|
| Device doesn’t appear in Pending | Check network connectivity. Verify the Stratos URL is correct. |
| Device shows as Offline | The player may not have completed setup. Check the player’s logs. |
| Authorization fails | Ensure you have write permission on screens. |
Related
Section titled “Related”- Device Tokens — pre-authorized device registration.
- Player Settings — configure player behavior.
- Screen Health — monitor device status.