Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/giof71/roon-bridge-docker
Run roon-bridge using docker (also on Volumio and Moode Audio)
https://github.com/giof71/roon-bridge-docker
arm64 armv7 docker docker-image moode moodeaudio osmc roon roon-bridge volumio x86-64
Last synced: about 1 month ago
JSON representation
Run roon-bridge using docker (also on Volumio and Moode Audio)
- Host: GitHub
- URL: https://github.com/giof71/roon-bridge-docker
- Owner: GioF71
- License: mit
- Created: 2023-03-27T13:38:12.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-30T09:08:58.000Z (2 months ago)
- Last Synced: 2024-10-30T10:18:18.601Z (2 months ago)
- Topics: arm64, armv7, docker, docker-image, moode, moodeaudio, osmc, roon, roon-bridge, volumio, x86-64
- Language: Shell
- Homepage:
- Size: 35.2 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Roon Bridge on Docker
## Links
Repo|URL
:---|:---
Source code|[GitHub](https://github.com/GioF71/roon-bridge-docker)
Docker images|[Docker Hub](https://hub.docker.com/r/giof71/roon-bridge)
## Available Archs on Docker Hub
- linux/amd64
- linux/arm/v7
- linux/arm64/v8
### 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:
```text
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`.
## Build docker image
Use the included script to build the image:
`./build.sh`
## Environment Variables
Variable|Description
:---|:---
BASE_URL|If set, files are downloaded from that URL instead of from the roon servers
FORCE_ARCH|If set, we are using the value instead of `uname -m` when selecting the binary file to use/download. This can be useful for example with LibreElec or OSMC on the Pi4, which have a 64bit kernel (`aarch64`) but a 32bit docker version: in this situation, then container starts but then the binary does not work. Setting this variable to `armv7l` solved the issue for me. Possible values are `aarch64`, `armv7l` and `x86_64`.
## Volumes
Volume|Description
:---|:---
/files|If set, we try and see if the volume contains the files that would instead be downloaded. Setting this volume can speed up the startup phase slightly.
## Example
You can use the published images or the one you build by yourself. See the repo [here](https://hub.docker.com/r/giof71/roon-bridge).
### Docker Run
```text
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
```text
---
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](https://containrrr.dev/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](https://moodeaudio.org/) and [Volumio](https://volumio.com/).
It is required to have a ssh connection to the Moode/Volumio audio box. In order to enable ssh on Volumio, refer to [this](https://developers.volumio.com/SSH%20Connection) page.
Those two platforms do not ship docker out of the box (unsurprisingly), so docker installation is required. See [Docker Installation](#install-docker) earlier in this page.
## Changelog
Date|Description
:---|:---
2023-09-28|Switch to debian stable by default (see [#20](https://github.com/GioF71/roon-bridge-docker/issues/20))
2023-03-29|Allow `BASE_URL` as alternate source for downloads
2023-03-29|Removed `/roon` mountpoint for ease of use
2023-03-29|Add volume `/files` for providing the necessary binary files (avoid downloads)
2023-03-27|Added `FORCE_ARCH` variable