Supysonic setup

This guide details the required steps to get a Supysonic instance ready to start serving your music.


For the impatient, here’s a quick summary to get Supysonic installed and ready to start serving (but this doesn’t create any user nor specifies where your music is located 😏). This uses gunicorn, but there are other options.

pip install git+
pip install gunicorn
gunicorn -b "supysonic.web:create_application()"

Table of contents


Another solution rather than going through the whole setup process yourself is to use a ready-to-use Docker image. While we don’t provide images for Supysonic, that didn’t keep the community from creating some. Take a look on the Docker Hub and pick one you like. For more details on their usage, please refer to the readme of said images.