Supysonic setup

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

TL;DR

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+https://github.com/spl0k/supysonic.git
pip install gunicorn
gunicorn -b 0.0.0.0:5000 "supysonic.web:create_application()"

Table of contents

• Installing Supysonic
  • Linux
  • Windows
  • Source
• Database setup
  • The PostgreSQL case
• Configuration
  • [base] section
  • [webapp] section
  • [daemon] section
  • [lastfm] section
  • [transcoding] section
  • [mimetypes] section
• Running the web server
  • Standalone WSGI Containers
  • Apache and mod_wsgi
  • Other options
• The daemon
  • Background scans
  • Library watching
  • Jukebox
  • Running it

Docker

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.