Swing Music

Blazingly fast, beautiful, self-hosted music streaming server for your own library

Alternative to: spotify, apple music

Swing Music is a self-hosted music streaming server built for people who want a Spotify-like experience for their own audio files. It offers a folder view, daily mixes curated from your listening activity, metadata normalization, album versioning, silence detection with cross-fade, and Last.fm scrobbling, all through a fast, modern browser-based UI. It runs on Windows, Linux, macOS and Docker, with dedicated Android and desktop clients.

Swing Music Docker Compose example

Self-host Swing Music on your own server, homelab, or VPS starting from this Docker Compose example. It runs Swing Music in Docker containers using the official ghcr.io/swingmx/swingmusic:latest image, 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:
  swingmusic:
    image: ghcr.io/swingmx/swingmusic:latest
    volumes:
      - music:/music
      - config:/config
    restart: unless-stopped
    environment:
      # Port the Swing Music server listens on inside the container.
      SWINGMUSIC_PORT: "1970"
      # Name this server reports to connected clients (browser, Android and desktop apps).
      SWINGMUSIC_DEVICE_NAME: "Swing Music"

volumes:
  music:
  config:

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