Getting started

This path establishes a working RelayTV endpoint before adding optional media servers or companion apps.

1. Confirm the model fits

RelayTV is not installed inside a smart TV or streaming stick. It runs on a Linux host connected directly to the television and renders playback through that host.

Review requirements before choosing hardware.

2. Install on the display host

mkdir -p ~/relaytv
cd ~/relaytv
curl -fsSL https://relaytv.app/install.sh | bash

The installer explains its choices and asks before installing Docker when it is missing. See Install RelayTV before running it if you want to review the script, force a runtime, or use an existing source checkout.

3. Open the local Web UI

From a phone or computer on the same network, open:

http://YOUR_RELAYTV_HOST:8787/ui

The host may be an IP address or a local DNS name.

4. Verify a first playback

Paste a supported media URL into the Web UI and choose Play now. Confirm:

1. the media starts on the attached display
2. the Web UI shows current playback state
3. play, pause, and seek control the endpoint
4. queueing a second item does not interrupt the current item

If the Web UI works but the display does not, start with display troubleshooting.

5. Secure and integrate

• Read the security and network model.
• Add Android, Home Assistant, or a media service.
• Learn the update path.

Canonical server source: installation guide. Reviewed 2026-08-29.