# Yamtrack

Self-hosted tracker for the media you watch, read and play.

- Replaces: [Trakt](https://openlogs.fyi/alternatives/trakt)
- Summary: Paid media tracking services, such as Trakt.
- Stack: Python (language), Redis (database)
- Deployment: docker_compose
- License: AGPL-3.0 (osi) [source](https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/LICENSE)
- Business model: unknown. The README at the pinned commit does not state a business model, so it stays unknown. ([source](https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/README.md), read 2026-10-22)
- Difficulty: medium. 2 services (1 database or broker: redis), 2 volume mounts, no env values to set, no elevated host access. Heuristic score 3 of 11: medium.
- Requirements: not stated
- Repository: [FuzzyGrim/Yamtrack](https://github.com/FuzzyGrim/Yamtrack)

## Install

1. Docker with the Compose plugin ([source](https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/docker-compose.yml))

   ```text
   A host with Docker and the Docker Compose plugin. This entry runs from a compose file.
   ```

2. Save the compose file as docker-compose.yml ([source](https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/docker-compose.yml))

   ```yaml
   services:
     yamtrack:
       container_name: yamtrack
       image: ghcr.io/fuzzygrim/yamtrack
       restart: unless-stopped
       depends_on:
         - redis
       environment:
         - TZ=Europe/Berlin
         - SECRET=longstring
         - REDIS_URL=redis://redis:6379
       volumes:
         - ./db:/yamtrack/db
       ports:
         - "8000:8000"
   
     redis:
       container_name: yamtrack-redis
       image: redis:8-alpine
       restart: unless-stopped
       volumes:
         - redis_data:/data
   
   volumes:
     redis_data:
   ```

3. Start it ([source](https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/docker-compose.yml))

   ```bash
   docker compose up -d
   ```

4. Open the app ([source](https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/docker-compose.yml))

   ```text
   Open http://localhost:8000. The compose file publishes host port 8000 for the yamtrack service.
   ```

Compose file check: config_ok on 2026-10-22.

## Gotchas and maintenance

### Gotchas

- Some images use the latest tag or no tag: Images without a pinned version: yamtrack: ghcr.io/fuzzygrim/yamtrack (no tag). A later pull can get a different version. ([source](https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/docker-compose.yml), checked 2026-10-22)
- The compose file publishes host ports: Host ports: 8000 (yamtrack). A port without a host address listens on all host network interfaces. ([source](https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/docker-compose.yml), checked 2026-10-22)
- The compose file mounts host folders: Host paths mounted into containers: ./db at /yamtrack/db (yamtrack). ([source](https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/docker-compose.yml), checked 2026-10-22)

### Signals

Computed from a GitHub snapshot taken 2026-10-22.

- Open issues and pull requests: 395
- Stars: 3719, forks: 356
- Last push: 2026-10-19 (2 days ago)
- Latest release: v0.26.3 on 2026-08-23 (59 days ago)

## Sources

- [Repository: https://github.com/FuzzyGrim/Yamtrack](https://github.com/FuzzyGrim/Yamtrack)
- [License: https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/LICENSE](https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/LICENSE)
- [Business model: https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/README.md](https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/README.md)
- [Compose file: https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/docker-compose.yml](https://github.com/FuzzyGrim/Yamtrack/blob/2d826214c0fe0785ac06a2e82c66a30f17d44956/docker-compose.yml)

---
Canonical: https://openlogs.fyi/tools/yamtrack  
Last updated: 2026-10-22