Tracearr

Watch Plex, Jellyfin and Emby streams, play stats and account sharing

  • ghcr.io/connorgallopo/tracearr:supervised-3.2.1
  • v3.2.1
  • Updated 20 Nov 2026
  • port 6757
  • amd64 · arm64
  • Media
  • 2.7k stars

Open the app

Web App

http://localhost:6757/

About Tracearr

Tracearr watches your Plex, Jellyfin and Emby servers in real time. See who is streaming what, look back at play history and stats, and catch accounts that are shared with people outside your home. This is upstream's all-in-one image, with PostgreSQL and Redis inside.

Features

  • Live view of every stream, with quality and transcode details
  • Play history and stats per user, title, device and day
  • Account-sharing detection: impossible travel, too many streams, new devices and locations
  • Rules that notify you or stop a stream
  • Several servers of different kinds in one dashboard
  • Notifications to Discord, ntfy and more, plus a mobile app

How to use

  1. Open Tracearr from your dashboard right after you install it.
  2. Make the owner account.
  3. Add your Plex, Jellyfin or Emby server with its address and token.
  4. Watch the dashboard fill up as people play things.

Before you install

Tracearr needs at least 3 GB of memory. It makes its own secrets on first start and keeps them in /DATA/AppData/tracearr/tracearr. Open http://[ZIMAOS-IP-ADDRESS]:6757 right after install and make the owner account. More settings (reverse proxy, poll interval) are in the Variables tab; add them in the app settings. The first start takes about 2 minutes.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone, for stats and history. It is filled in from your ZimaOS time zone.

Server

VariableDefault valueDescription
TRUST_PROXY—Set to true behind one reverse proxy, so Tracearr sees real client addresses. Use 2 for two proxies, or list the proxy addresses.
CORS_ORIGIN*Other websites that may use a signed-in session, separated by commas, like https://dash.example.com. Not needed for Tracearr itself.
GZIP_ENABLED—Set to true to compress answers, when no reverse proxy does it.
ENCRYPTION_KEY—Your own key for stored server tokens and notification secrets. Leave it out; Tracearr uses the secrets it made on first start.

Monitoring

VariableDefault valueDescription
POLLER_ENABLEDtrueSet to false to stop checking your media servers for streams.
POLLER_INTERVAL15000How often to check your media servers, in milliseconds.

Mobile app

VariableDefault valueDescription
MOBILE_BETA_MODE—Set to true for beta testing the mobile app: reusable pairing tokens that never expire. Not for everyday use.

Logs

VariableDefault valueDescription
LOG_LEVELinfoHow much Tracearr logs: error, warn, info or debug.
docker-compose.yml
name: tracearr

services:
  tracearr:
    image: ghcr.io/connorgallopo/tracearr:supervised-3.2.1
    container_name: tracearr
    restart: unless-stopped
    stop_grace_period: 90s
    network_mode: bridge
    shm_size: 512mb
    ulimits:
      nofile:
        soft: 65536
        hard: 65536
    environment:
      - TZ=$TZ
    ports:
      - target: 3000
        published: "6757"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/postgres
        target: /data/postgres
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/AppData/$AppID/redis
        target: /data/redis
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/AppData/$AppID/tracearr
        target: /data/tracearr
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/AppData/$AppID/backup
        target: /data/backup
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://127.0.0.1:3000/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 120s
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 3072M
        reservations:
          cpus: "0.25"
          memory: 512M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tracearr/icon.png
    x-casaos:
      id: com.icestore.tracearr
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone, for stats and history. It is filled in from
              your ZimaOS time zone.
      ports:
        - container: "3000"
          description:
            en_US: Tracearr web app and API, published on host as 6757
      volumes:
        - container: /data/postgres
          description:
            en_US: The PostgreSQL (TimescaleDB) database with all play history.
        - container: /data/redis
          description:
            en_US: Redis, for live sessions and the job queue.
        - container: /data/tracearr
          description:
            en_US: >-
              Tracearr's files and the secrets it makes on first start
              (.jwt_secret, .cookie_secret). Back it up.
        - container: /data/backup
          description:
            en_US: Database backups made from Tracearr's settings.

x-casaos:
  id: com.icestore.tracearr
  architectures:
    - amd64
    - arm64
  main: tracearr
  author: HSinghHira
  category: Media
  developer: Connor Gallopo
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tracearr/icon.png
  title:
    en_US: Tracearr
  tagline:
    en_US: Watch Plex, Jellyfin and Emby streams, play stats and account sharing
  description:
    en_US: >-
      Tracearr watches your Plex, Jellyfin and Emby servers in real time. See
      who is streaming what, look back at play history and stats, and catch
      accounts that are shared with people outside your home. This is
      upstream's all-in-one image, with PostgreSQL and Redis inside.


      **Features**


      - Live view of every stream, with quality and transcode details

      - Play history and stats per user, title, device and day

      - Account-sharing detection: impossible travel, too many streams,
        new devices and locations

      - Rules that notify you or stop a stream

      - Several servers of different kinds in one dashboard

      - Notifications to Discord, ntfy and more, plus a mobile app


      **How to use?**


      1. Open Tracearr from the ZimaOS dashboard right after you install
         it.

      2. Make the owner account.

      3. Add your Plex, Jellyfin or Emby server with its address and token.

      4. Watch the dashboard fill up as people play things.
  tips:
    before_install:
      en_US: >-
        1. Tracearr needs at least 3 GB of memory.


        2. More settings, like reverse proxy trust and the poll interval, are
           listed on the Tracearr page at
           https://icestore.hsinghhira.me/app/tracearr/ (Variables tab). You
           can add them now or later in the app settings.


        3. Start the installation. The first start takes about 2 minutes.


        4. Open http://[ZIMAOS-IP-ADDRESS]:6757 right away and make the
           owner account.


        5. Add your Plex, Jellyfin or Emby server in the setup.
  index: /
  port_map: "6757"
  scheme: http
  is_uncontrolled: false
  version: "3.2.1"
  update_at: "2026-11-20"
  release_notes:
    en_US: |-
      - First IceStore release, on port 6757
      - Uses ghcr.io/connorgallopo/tracearr supervised-3.2.1, upstream's all-in-one image with PostgreSQL 15 (TimescaleDB) and Redis inside
      - Tracearr makes its own secrets on first start and keeps them in the data folder
  repo: "https://github.com/connorgallopo/tracearr"
  support: "https://github.com/connorgallopo/tracearr/issues"
  docs: "https://docs.tracearr.com"

Install Tracearr

Something not working with Tracearr?

Report it so it gets fixed, or ask for an app that is not here yet.

More Media apps

See all