stuckj/subsonic repository overview

⁠subsonic-docker

This is a simple Docker container for subsonic. You can customize some aspects of subsonic via environment variables. See the table below for customization options.

⁠Environment Variables

⁠Tracker (MOD, S3M, etc) / MIDI support

The container has ffmpeg, mikmod (for screamtracker modules), timidity (for midi files), and LAME (for encoding screamtracker and midi files to MP3). Subsonic is not, by default, configured to use mikmod or timitidy. You must add the configuration. In the transcoding section, add a configuration like the following for screamtracker / etc files:

The mikmod_stdout and timidity_stdout scripts are simple scripts that run mikmod and timidity sending the output to stdout in wav format for lame to use for encoding. If you have no need to handle tracker or midi files than you can safely ignore this configuration.

⁠Volumes

The container will use volumes for for the following directories within the container:

⁠Permissions

Subsonic will be run by a service user inside the container (subsonic) with the UID / GID configured via the SUBSONIC_UID/SUBSONIC_GID environment variables (Default 1000/1000). The permissions will be set on any directory / volume you map onto /var/subsonic so that it is owned by subsonic:subsonic. If you are transferring a subsonic installation to this container make sure to change ownership of everything under /var/subsonic to subsonic:subsonic. You can do this with this command: chmod -R subsonic:subsonic DIR where DIR is the directory you are mapping to /var/subsonic.

The permissions on any music, playlist, etc must be at least readable by subsonic:subsonic.

⁠Docker run

Here is an example docker run command that you can use to run the container:

docker run -it \
    -p "4040:4040/tcp" \
    -v /data/music:/var/music \
    -v /data/subsonic-data:/var/subsonic \
    --name="subsonic" \
    stuckj/subsonic:latest

Here's another example with environment variable customizations:

docker run -it \
    -p "8080:8080/tcp" \
    -eSUBSONIC_PORT=8080 \
    -eSUBSONIC_MAX_MEMORY=512 \
    -eSUBSONIC_UID=33 \
    -eSUBSONIC_GID=33 \
    -v /data/music:/var/music \
    -v /data/playlists:/var/playlists \
    -v /data/subsonic-data:/var/subsonic \
    --name="subsonic" \
    stuckj/subsonic:latest

⁠Docker compose

Here is an example docker-compose.yaml if you choose to run with docker compose:

version: '2'
services:
  subsonic:
    image: stuckj/subsonic:latest
    restart: unless-stopped
    environment:
      - SUBSONIC_MAX_MEMORY=512
      - SUBSONIC_PORT=8080
      - SUBSONIC_UID=33
      - SUBSONIC_GID=33
    ports:
      - 8080:8080/tcp
    volumes:
      - /data/music:/var/music
      - /data/playlists:/var/playlists
      - /data/subsonic-data:/var/subsonic

⁠TODOs

TODO: Setup auto-detection of new versions in Dockerfile (will need to scrape page).