Your Spotify

Self hosted Spotify tracking dashboard

Alternative to: Spotify Wrapped, Last.fm

Your Spotify is a self-hosted application that tracks what you listen to on Spotify and offers a dashboard to explore statistics about your habits. It is composed of a web server that periodically polls the Spotify API and a web app for exploring listening statistics, with support for importing historical data from Spotify privacy exports and generating shareable public profile links.

Your Spotify Docker Compose example

Self-host Your Spotify on your own server, homelab, or VPS starting from this Docker Compose example. It runs Your Spotify in Docker containers using the official yooooomi/your_spotify_server:latest, yooooomi/your_spotify_client:latest, mongo:8 images, with persistent volumes and automatic restarts preconfigured. Review the environment variables and adjust them to your setup, save the file as compose.yml (or docker-compose.yml), and start the stack with docker compose up -d.

services:
  server:
    image: yooooomi/your_spotify_server:latest
    depends_on:
      - mongo
    environment:
      # Public URL where the browser reaches the backend API server. Must be reachable from your browser.
      API_ENDPOINT: "http://localhost:8080"
      # Public URL where the web frontend is served.
      CLIENT_ENDPOINT: "http://localhost:3000"
      # Spotify application Client ID. Create an app at https://developer.spotify.com/dashboard.
      SPOTIFY_PUBLIC: "changeme"
      # Spotify application Client Secret.
      SPOTIFY_SECRET: "changeme"
      # Timezone used when aggregating listening statistics.
      TIMEZONE: "UTC"
    restart: unless-stopped

  web:
    image: yooooomi/your_spotify_client:latest
    depends_on:
      - server
    environment:
      # Public URL where the browser reaches the backend API server (same value as the server's API_ENDPOINT).
      API_ENDPOINT: "http://localhost:8080"
    restart: unless-stopped

  mongo:
    image: mongo:8
    volumes:
      - db_data:/data/db
    restart: unless-stopped

volumes:
  db_data:

Values set to changeme are required — replace them with your own values before starting Your Spotify.

Prefer a managed setup? WinterFlow installs, configures, and updates Your Spotify for you using this same Docker Compose configuration.