# 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 supysonic
    pip install gunicorn
    supysonic-server

Table of contents

- Installing Supysonic
  - Linux
  - Windows
  - pip
- Database setup
  - The PostgreSQL case
- Configuration
  - `[base]` section
  - `[webapp]` section
  - `[daemon]` section
  - `[lastfm]` section
  - `[transcoding]` section
  - `[mimetypes]` section
- Running the web server
  - supysonic-server
  - 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.