Start here

Connect your Jellyfin server

Remedia needs one thing to start: your Jellyfin server. This page covers the first screen, both ways to sign in, and what the messages mean.

Before you start

Your server runs Jellyfin 10.10 or newer.
You know its address and port, for example http://192.168.1.100:8096.
The Apple TV can reach it: it is on the same network, or the address works from outside your home.

Remedia does not look for servers on your network. The address is always typed.

On Welcome to Remedia, select the Jellyfin card.
Select Server Address and type your server's address. The keyboard opens as soon as you select a field.
Fill in Username and Password. Leave the password empty if your account has none.
Select Sign In.
The card now shows a tick and your server's name, and Start Watching appears. Select it to open Home.

Your password is used once, to sign in. Remedia keeps the access token Jellyfin returns, not the password.

Quick Connect signs you in without typing a password on the TV.

Fill in Server Address only.
Select Quick Connect. Remedia shows a code.
On a phone or computer already signed in to Jellyfin, open Jellyfin's settings, choose Quick Connect, and enter the code.
Remedia checks every few seconds and signs in once the code is approved.

Quick Connect has to be switched on in the server's dashboard, under General. If it is off, Remedia says so.

An address typed without http:// or https:// is taken as https://.
The exception is a server at home: a private address such as 192.168.1.100, a .local name, or a name with no dot in it. Those are taken as http://.
http:// typed in full is always kept.
An address copied from a browser is trimmed back to the server, so the part after the port does not matter.

A sign-in that fails shows Couldn't Sign In with one of these.

Message	What to do
Jellyfin didn't accept that username and password.	Check both. Capital letters matter in the password.
Couldn't reach that server. Check the address and port.	Check the address, the port, and that the Apple TV is on a network that can reach the server.
That address isn't a Jellyfin server. Check the port.	Something answered, but not Jellyfin. The port is the usual cause: Jellyfin's is 8096 unless you changed it.
This server's HTTPS certificate isn't trusted.	Use the name the certificate was made for. At home, the server's local address with http:// works too.
This server runs Jellyfin (version). Remedia needs 10.10 or newer.	Update the server.
Quick Connect is off on this server.	Turn it on in the Jellyfin dashboard, under General, or sign in with your password.
That code expired. Try again.	Select Quick Connect again for a new code.

Remedia is signed in to one Jellyfin server as one user at a time. To use another server or another user, sign out and sign in again.

Open Settings, then Jellyfin Server, then Sign Out. It signs out at once, without asking.

If iCloud Sync is on and the sign-in is shared with your other devices, Remedia asks first whether to sign out of This Device Only or All Devices.

With nothing signed in, Remedia goes back to the Welcome screen.

Next: Home