Install RelayTV

Before running the installer

1. Confirm the host meets the requirements.
2. Open the installer source if you want to review each operation before piping it to Bash.
3. Back up an existing RelayTV directory before replacing or reconfiguring it.

Default installation

Run this on the Linux host connected to the television:

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

The relaytv.app/install.sh route serves a short-lived cached copy of the installer from the server repository. A failed analytics request never blocks the script response.

Options

Download the script before running it when you need to inspect help or pass arguments:

curl -fsSL https://relaytv.app/install.sh -o install.sh
chmod +x install.sh
./install.sh --help

The canonical guide documents directory, branch, image, Docker-installation, CEC, runtime, and overwrite choices. Avoid forcing a runtime until you understand what the host currently exposes.

Verify the generated deployment

cd ~/relaytv
docker compose config --quiet
docker compose ps
docker compose logs --tail=100 relaytv

Then follow First playback.

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