Skip to content
RelayTVRelayTV Docs

Update RelayTV

Before updating

Section titled “Before updating”
  • Read the latest release notes.
  • Record the current image reference and working configuration.
  • Back up .env, the generated Compose override, and RelayTV persistent data.
  • Check companion compatibility when the release changes an API or realtime transport.

Update a standard installation

Section titled “Update a standard installation”
Terminal window
cd ~/relaytv
docker compose config --quiet
docker compose pull
docker compose up -d --wait --wait-timeout 180

If your installed Compose version does not support --wait, run docker compose up -d, then inspect health separately.

Verify

Section titled “Verify”
Terminal window
docker compose ps
curl -fsS http://127.0.0.1:8787/health
docker compose logs --tail=100 relaytv

Then start real playback on the attached display and test at least one existing companion app.

Rollback preparation

Section titled “Rollback preparation”

Do not prune the previous image until verification succeeds. If a release fails on the host, restore the prior image reference and preserved configuration, then redeploy and verify again.

Canonical server source: release process and notes. Reviewed 2026-08-29.