# Tracearr

Tracearr is a self-hosted monitoring dashboard for Plex, Jellyfin, and Emby servers that tracks live sessions, stream analytics, live television and music playback, geolocation, and account-sharing signals for. It is open source and self-hosted, installable on Proxmox, Unraid and TrueNAS.

Canonical page: https://ourlocalhost.com/app/3407/tracearr

## Description

Tracearr is a self-hosted monitoring dashboard for Plex, Jellyfin, and Emby servers that tracks live sessions, stream analytics, live television and music playback, geolocation, and account-sharing signals for administrators who need centralized usage review and real-time sharing alerts.

## Platform availability

Available on 4 of 10 platforms: Unraid, TrueNAS, Proxmox, Any server.

## Health score

65/100 (Good), based on 4 of 4 factors.
- Maintained: 91 (last commit 19 days ago)
- Popular: 34 (47 GitHub stars)
- Easy to install: 65 (4 install platforms, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)

## Links

- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=tracearr
- Unraid: https://ca.unraid.net/apps/tracearr-1t8jx2j1ft77hz?q=tracearr
- TrueNAS: https://apps.truenas.com/catalog/tracearr/
- Documentation: https://docs.tracearr.com
- Official website: https://tracearr.com
- GitHub: https://github.com/connorgallopo/Tracearr

## Common questions

### How should I generate the required Tracearr secrets?

Create a .env file containing JWT_SECRET and COOKIE_SECRET using the provided openssl commands before starting the app. These secrets protect logins and sessions, and missing values can make the app unsafe or fail to sign user data.

### What should I check if the container won't start?

Run docker logs tracearr, tracearr-postgres, and tracearr-redis to look for errors. This usually reveals missing database connections, bad secrets, or cache problems.

### How do Jellyfin and Emby provide stream data to Tracearr?

Plex reports its own numbers, while Jellyfin and Emby report through the Tracearr SSE plugin.

### Does the interactive stream map require external tile keys?

No, the vector basemap ships inside the container, so there are no tile keys or requests to a third-party tile service. You can give a server a location so local network plays show there too.

### How does a merged identity's trust score work?

The trust score is the worst of the identity's active accounts, so merging duplicates does not hide a problem. You can merge by hand or use suggestions, and split them again if wrong.

---
Source: Our Local Host (https://ourlocalhost.com/app/3407/tracearr), the self-hosted and open-source app directory.
