Skip to Content
Getting StartedConnect a Server

Connect a Server

After installing Tracearr, you’ll connect your first media server during the initial setup.

Initial Setup

When you first access Tracearr, you’ll be prompted to sign in or create an account.

  1. Click Sign in with Plex
  2. A popup opens — sign in with your Plex account
  3. Tracearr discovers your Plex servers automatically
  4. Select the server you want to monitor
  5. You’re done — Tracearr begins tracking sessions

Plex servers must be owned by (or shared with admin access to) the Plex account you sign in with.

Single Sign-On (OIDC)

If your Tracearr instance is configured with an OIDC identity provider (Authentik, Authelia, Keycloak, and similar), the login page shows an SSO button. Click it to sign in through your provider, then connect servers as described below. See OIDC Single Sign-On for the required environment variables.

Jellyfin

  1. Click Create Account and set up a local Tracearr account
  2. After account creation, go to Settings → Servers
  3. Click Add Server and select Jellyfin
  4. Enter your server details:
    • Server URL — e.g., http://192.168.1.100:8096
    • Server Name — A friendly name for the server
    • API Key — From Jellyfin Dashboard → API Keys
  5. Click Connect

Emby

  1. Click Create Account and set up a local Tracearr account
  2. After account creation, go to Settings → Servers
  3. Click Add Server and select Emby
  4. Enter your server details:
    • Server URL — e.g., http://192.168.1.100:8096
    • Server Name — A friendly name for the server
    • API Key — From Emby Server → API Keys
  5. Click Connect

Jellyfin and Emby sessions are detected by polling out of the box. For instant, push-based sessions like Plex, install the Tracearr SSE plugin.

Signing in to Tracearr with Jellyfin credentials was removed. You sign in with a local Tracearr account, Plex, or SSO; Jellyfin and Emby servers are still fully supported for monitoring via API key as described above. If your install only ever logged in with Jellyfin credentials, see Account Recovery to regain access.

Adding More Servers

You can monitor multiple servers from a single Tracearr instance. Go to Settings → Servers to add more.

Adding Plex Servers

Plex servers are tied to Plex accounts. To add servers from a different Plex account:

  1. Go to Settings → Servers
  2. Scroll to Linked Plex Accounts
  3. Click Link Account and sign in with the additional Plex account
  4. Return to Add Server → Plex and select from the newly linked account’s servers

Adding Jellyfin/Emby Servers

Click Add Server, select the server type, and enter the URL and API key. You’ll need administrator access to generate an API key.

Getting API Keys

Jellyfin

  1. Open Jellyfin and go to Dashboard → API Keys
  2. Click the + button to create a new key
  3. Give it a name (e.g., “Tracearr”)
  4. Copy the generated key

Emby

  1. Open Emby and go to Dashboard → API Keys
  2. Click New API Key
  3. Give it a name (e.g., “Tracearr”)
  4. Copy the generated key

Next Steps

Once connected, Tracearr will begin tracking sessions and collecting analytics. Check out the Configuration guide to customize alerts, sharing detection rules, and more.

Last updated on
Railway (Cloud)Import Data