Skip to content
Supysonic Docker container
Shell Dockerfile
Branch: master
Clone or download
This branch is 1 commit ahead of uGeek:master.

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.

Supysonic docker container

Just a simple Docker container that gets rebuild on every python update.

Currently only supports local sqlite as storage.


  • Be sure to add /var/lib/supysonic as a volume to store passwords and your music databse
  • Add your music in /media as a volume
  • You can specify a own password by using a docker secred named supysonic
  • If you do not specify a secret you will see one in the logs
  • The webserver runs on port 8080
  • If you want to disable the watcher use the RUN_WATCHER environment variable

Example for docker-compose

Here is a simple example for docker-compose and Traefik.

    image: foosinn/supysonic
      - "/tank/Musik:/media:ro"  # add your music folder hiere
      - "/opt/supysonic:/var/lib/supysonic"  # config folder
      - "traefik.frontend.rule=Host:"
      - "traefik.port=8080"
docker run --name supysonic -v $HOME/docker/supysonic:/var/lib/supysonic -v /media:/media -p 8080:8080 ugeek/supysonic:arm


To start using Supysonic, you'll first have to specify where your music library is located and create a user to allow calls to the API.

Let's start by creating a new admin user this way:

$ supysonic-cli user add MyUserName -a -p MyAwesomePassword

To add a new folder to your music library, you can do something like this:

$ supysonic-cli folder add MyLibrary /home/username/Music

Once you've added a folder, you will need to scan it:

$ supysonic-cli folder scan MyLibrary

You should now be able to enjoy your music with the client of your choice!

For more details on the command-line usage, take a look at the documentation.

Alpine Linux Version

  • Alpine Linux 3.9

Version of supysonic

You can’t perform that action at this time.