This repository contains configuration files for building a Docker image for the Airsonic media streamer.

WARNING: this image is not maintained against upstream changes anymore. Airsonic itself is not maintained anymore, leading to yet another fork I do not want to get down into. I have switched to Navidrome.

Noteworthy

• Airsonic (latest version)
• Debian (latest stable)
• Runs as normal user (UID 10000)
• Checks upstream OpenPGP signatures

This was created because no other Docker build had those properties at the time. The official Docker image, for example, runs as root and builds on top of Alpine instead.

Build your own image

$ docker build -t <your-name>/debian-airsonic debian-airsonic

Get a pre-built image

A current image is available as a build from the GitLab.com Docker registry:

docker pull registry.gitlab.com/anarcat/debian-airsonic

It is also available from Docker hub:

$ docker pull anarcat/debian-airsonic

The Docker repository page is at:

https://hub.docker.com/r/anarcat/debian-airsonic/

Note that this image is built and uploaded by hand so it might be out of date.

(That is because I disagree with Docker Hub's security policies: It requires a deploy key to be added to my account to configure automatic builds. I find that abusive and a gross disruption of proper authentication boundaries.)

Run a container with this image

$ docker run \
  --detach \
  --publish 8080:8080 \
  --volume "/wherever/your/music/is:/var/music:ro" \
  <your-name>/debian-airsonic

Arguments passed to docker run will be passed as-is on the Airsonic commandline, see the upstream configuration guide for more information about available options. For example, to enable TLS, you could do:

$ docker run \
  --detach \
  --publish 4040:4040 \
  --volume "/wherever/your/music/is:/var/music:ro" \
  <your-name>/debian-airsonic \
  -Dserver.ssl.enabled=true \
  [...]

Pitfalls

The host music directory mounted into the container at /var/music must be readable by user airsonic (UID 10000).

If you use a volume for the container's /var/airsonic, the host directory mounted there must have read-write-execute permissions for user airsonic (UID 10000).

Credits

This repository is maintained by anarcat but was partly based on work by mschuerig.