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
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
- Open Tracearr from your dashboard right after you install it.
- Make the owner account.
- Add your Plex, Jellyfin or Emby server with its address and token.
- 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
| Variable | Default value | Description |
|---|---|---|
TZ | $TZ | Your time zone, for stats and history. It is filled in from your ZimaOS time zone. |
Server
| Variable | Default value | Description |
|---|---|---|
TRUST_ | — | Set to true behind one reverse proxy, so Tracearr sees real client addresses. Use 2 for two proxies, or list the proxy addresses. |
CORS_ | * | Other websites that may use a signed-in session, separated by commas, like https://dash.example.com. Not needed for Tracearr itself. |
GZIP_ | — | Set to true to compress answers, when no reverse proxy does it. |
ENCRYPTION_ | — | Your own key for stored server tokens and notification secrets. Leave it out; Tracearr uses the secrets it made on first start. |
Monitoring
| Variable | Default value | Description |
|---|---|---|
POLLER_ | true | Set to false to stop checking your media servers for streams. |
POLLER_ | 15000 | How often to check your media servers, in milliseconds. |
Mobile app
| Variable | Default value | Description |
|---|---|---|
MOBILE_ | — | Set to true for beta testing the mobile app: reusable pairing tokens that never expire. Not for everyday use. |
Logs
| Variable | Default value | Description |
|---|---|---|
LOG_ | info | How much Tracearr logs: error, warn, info or debug. |
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.
ZimaOS
Add the store link, then find Tracearr in the App Store and install it.
CasaOS
Add the store link, then find Tracearr in the App Store and install it.
ReCasaOS
Add the store link, then find Tracearr in the App Store and install it.
Homeio
Add the store link, then find Tracearr in the App Store and install it.
MOS
Add the repository in MOS Hub Settings, then find Tracearr in Docker → MOS Hub and install it.