giof71/roon-bridge repository overview

⁠Roon Bridge on Docker

⁠Links

⁠Support

Please see the Goal⁠.
Please note that support goal is limited to cover running costs for subscriptions to music services.

⁠Available Archs on Docker Hub

• linux/amd64
• linux/arm64/v8
• linux/arm/v7

⁠Install Docker

Docker is a prerequisite. On debian and derived distributions (this includes Raspberry Pi OS, DietPi, Moode Audio, Volumio, OSMC), we can install the necessary packages using the following commands:

sudo apt-get update
sudo apt-get install -y docker.io docker-compose
sudo usermod -a -G docker $USER

The last command adds the current user to the docker group. This is not mandatory; if you choose to skip this step, you might need to execute docker-compose commands by prepending sudo.
Please note that this is not necessarily the best way of installing docker on your machine. First of all, the suggested method installs the packages from the distribution repositories. You might prefer to install from the docker repositories in order to have a more updated version.
You can use this solution with Podman as well. See this discussion⁠.

⁠Build docker image

Use the included script to build the image:

./build.sh

⁠Environment Variables

⁠Volumes

⁠Example

You can use the published images or the one you build by yourself. See the repo here⁠.

⁠Docker Run

docker run \
    -d \
    --name roon-bridge \
    --restart always \
    --network host \
    --device /dev/snd \
    --label com.centurylinklabs.watchtower.enable=false \
    giof71/roon-bridge:latest

⁠Docker Compose

---
version: "3"

services:
  roon-bridge:
    container_name: roon-bridge
    image: giof71/roon-bridge:latest
    network_mode: host
    devices:
      - /dev/snd:/dev/snd
    labels:
      - com.centurylinklabs.watchtower.enable=false
    restart: always

⁠Disabling watchtower

Watchtower⁠ is an excellent tool, but it can disrupt your listening experience if an image update can trigger a container recreation.
I am therefore keeping watchtower disabled in my examples.

⁠Installation on Moode Audio or Volumio

It is possible to use this solution for easy installation of Roon Bridge on Moode Audio⁠ and Volumio⁠.
It is required to have a ssh connection to the Moode/Volumio audio box. In order to enable ssh on Volumio, refer to this⁠ page.
Those two platforms do not ship docker out of the box (unsurprisingly), so docker installation is required. See Docker Installation⁠ earlier in this page.

⁠Changelog