Skip to content

TrackWatch

v2.1.0 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

Published 3mo Media Servers
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

automation django django-rest-framework docker music music-tracker
+7 more
python react release-radar self-hosted spotify spotify-api vite

Summary

AI summary

All-in-One Docker Image simplifies TrackWatch deployment with a single container.

Full changelog

Changelog

v2.1.0 — All-in-One Docker Image

✨ New Features

  • All-in-One Docker Image: Deploy TrackWatch with a single docker run command. One container includes PostgreSQL, Nginx, Django, and the background scheduler — managed by supervisord.
  • Pre-built Images: Available on GHCR and Docker Hub. No cloning or building required.
  • Runtime Environment Injection: Pre-built images can be fully configured at startup via environment variables — no need to rebuild for different Spotify credentials or domains.
  • Automated Publishing: GitHub Actions workflow builds and publishes the AiO image on every semver tag (e.g. 2.1.0) to both GHCR and Docker Hub.
  • Configurable Email Domain: Self-hosters can now set EMAIL_DOMAIN to use their own Resend-verified domain for email notifications.
  • Updated Install Page: The frontend /install page now features an AiO tab with copy-paste docker run commands for both GHCR and Docker Hub.

🔧 Improvements

  • Background Processing: New releases update now runs in a background thread to prevent Gunicorn worker timeout.
  • Hide Login Button: New VITE_HIDE_PUBLIC_LOGIN environment variable to hide the login button for public instance.
  • Dependency Updates: Django 5.2.11, react-router-dom 7.

📦 Quick Start

docker run -d \
  --name trackwatch \
  -e SPOTIFY_CLIENT_ID=your-client-id \
  -e SPOTIFY_CLIENT_SECRET=your-client-secret \
  -e SECRET_KEY=your-secret-key \
  -v trackwatch_data:/var/lib/postgresql/data \
  -p 80:80 \
  --restart unless-stopped \
  ghcr.io/emlopezr/trackwatch:latest

Open http://127.0.0.1 and you're done.

For the full setup guide, see docs/DOCKER_AIO_SETUP.md.

⚠️ No Breaking Changes

The existing docker-compose.yml multi-container setup continues to work exactly as before. The AiO image is a new deployment option, not a replacement.

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track TrackWatch

Get notified when new releases ship.

Sign up free

About TrackWatch

Automated music release tracker for Spotify with email notifications, discography generator, and ghost track cleaner (alternative to Release Radar).

All releases →

Beta — feedback welcome: [email protected]