deaffella / shairport-sync

Dockerized shairport-sync

About

Modified source code from: https://github.com/kevineye/docker-shairport-sync

Intro

shairport-sync is an Apple AirPlay receiver. It can receive audio directly from iOS devices, iTunes, etc. Multiple instances of shairport-sync will stay in sync with each other and other AirPlay devices when used with a compatible multi-room player, such as iTunes or forked-daapd.

Multi-arch Image

The below commands reference a Docker Manifest List at tigerj/shairport-sync built using Docker's BuildKit. Simply running commands using this image will pull the matching image architecture (e.g. amd64, arm32v7, or arm64) based on the hosts architecture. Hence, if you are on a Raspberry Pi the below commands will work the same as if you were on a traditional amd64 desktop/laptop computer.

Run

To simply run a container from the image in daemon mode:

docker run \
       -d \
       --restart=always \
       --net=host \
       --device /dev/snd \
       -e AIRPLAY_NAME=shairport-sync \
       tigerj/shairport-sync

Create

To create a container from the image (for later use):

docker create \
       --restart=always \
       --name=shairport-sync \
       --net=host \
       --device /dev/snd \
       -e AIRPLAY_NAME="shairport-sync" \
       tigerj/shairport-sync

Then run this container by name using docker start:

docker start shairport-sync

Parameters

• --net host must be run in host mode
• --device /dev/snd share host alsa system with container. Does not require --privileged as -v /dev/snd:/dev/snd would
• -e AIRPLAY_NAME=Docker set the AirPlay device name. If unset it defaults to "Docker"
• extra arguments will be passed to shairplay-sync (try -- help)

Troubleshooting

A few little tips for getting your setup working

Configure Audio Group Access

To set the volume max on your system, please make sure you are first in the audio group by running the command:

$ groups $USER
USER: USER sudo audio docker

If your output contains the audio group, then you already have access. If not then run the following:

sudo usermod -a -G audio $USER

This will add $USER to the audio group (and assumes you have sudo privileges). NOTE: you must reboot for this change to take effect!

Linux Volume Level

Assuming you have audio group privileges (see Configure Audio Group Access), you can adjust the volume on linux with the alsamixer command:

$ alsamixer

which will bring up the following screen:

Simply use the UP/DOWN arrow keys to set the volume to what you want (here it has been set to 100%).