{"id":22320180,"url":"https://github.com/giof71/audirvana-docker","last_synced_at":"2026-02-26T00:32:29.969Z","repository":{"id":245179564,"uuid":"817493562","full_name":"GioF71/audirvana-docker","owner":"GioF71","description":"Run Audirvana Studio and Audirvana Origin using Docker","archived":false,"fork":false,"pushed_at":"2024-08-29T16:16:10.000Z","size":36,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T13:42:53.335Z","etag":null,"topics":["amd64","arm64","audio-library","audio-player","audiophile","audirvana","docker","qobuz","raspberry-pi","streaming-audio","tidal"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GioF71.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-19T20:46:41.000Z","updated_at":"2025-03-16T08:20:51.000Z","dependencies_parsed_at":"2024-06-20T09:57:00.559Z","dependency_job_id":"22f126ae-b01b-44ea-892d-ddf876924a54","html_url":"https://github.com/GioF71/audirvana-docker","commit_stats":null,"previous_names":["giof71/audirvana-docker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GioF71/audirvana-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GioF71%2Faudirvana-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GioF71%2Faudirvana-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GioF71%2Faudirvana-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GioF71%2Faudirvana-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GioF71","download_url":"https://codeload.github.com/GioF71/audirvana-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GioF71%2Faudirvana-docker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267694877,"owners_count":24129149,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amd64","arm64","audio-library","audio-player","audiophile","audirvana","docker","qobuz","raspberry-pi","streaming-audio","tidal"],"created_at":"2024-12-04T00:12:43.013Z","updated_at":"2026-02-26T00:32:24.949Z","avatar_url":"https://github.com/GioF71.png","language":"Shell","funding_links":["https://ko-fi.com/H2H7UIN5D","https://ko-fi.com/giof71/goal?g=0"],"categories":[],"sub_categories":[],"readme":"# audirvana-docker\n\n## Support me\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/H2H7UIN5D)  \nPlease see the [Goal](https://ko-fi.com/giof71/goal?g=0)  \nPlease note that support goal is limited to cover running costs for subscriptions to music services.\n\n## References\n\nThis is a set of tools you can use in order to build and run docker images for Audirvana Studio and Audirvana Origin. See [here](https://audirvana.com/linux/) for more information.  \n\n## Supported Platforms\n\nThe Audirvana applications can run on amd64 and on arm64 platforms.  \nThis includes Raspberry Pi SBC with a 64 bit version of Raspberry Pi OS.\n\n## Disclaimer\n\nI won't build and publish images which would include binaries from the Audirvana company.  \nThis means that there are no releated images available on docker hub. You will have to build your image yourself.  \nThe images resulting from applying the build recipe described in this repository will include the latest studio/origin binaries.  \nWhen a new release is published, you will need to re-build your image, so that it will include the latest available version.  \n\n## Prerequisites\n\n### Docker\n\nDocker must be installed on your system. Refer to your linux distribution documentation. For debian/ubuntu, you can refer to the next section.  \n\n#### Install Docker on Debian/Ubuntu\n\nOn debian and derived distributions (this includes Raspberry Pi OS, DietPi, Moode Audio, Volumio), we can install the necessary packages using the following commands:\n\n```text\nsudo apt-get update\nsudo apt-get install docker.io docker-compose\nsudo usermod -a -G docker $USER\n```\n\nThe 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`.  \nPlease note that this method uses the docker packages available on the distro repositories.  \nIf you want to install more up-to-date versions, refer to the guides [here](https://docs.docker.com/desktop/install/linux-install/)\n\n### Clone the repository\n\nYou need to clone the repository. Make sure that `git` is installed using the following command on debian and derived distributions (again, this includes Raspberry Pi OS, DietPi, Moode Audio, Volumio):\n\n```code\nsudo apt-get update\nsudo apt-get install -y git\n```\n\nMove to the your home directory and clone the repository using the commands:\n\n```code\ncd\ngit clone https://github.com/GioF71/audirvana-docker.git\n```\n\nThe rest of the documentation will assume that you have cloned the repository in the suggested directory. If you operated differently, be sure to check and modify the commands appropriately.  \n\n### Update the repository\n\nIf you just downloaded the repository, you can skip this step.  \nIf you previously cloned the repository, it might have been updated in the meantime. Move to the directory and pull the changes:\n\n```code\ncd $HOME/audirvana-docker\ngit config pull.rebase false\ngit pull\n```\n\n## Build\n\nYou can build your own images using the convenience scripts available in the root directory of this repository, `build-origin.sh` and `build-studio.sh`.  \nFrom a terminal, you will need to enter one of the following, depending of the version of Audirvana you want to build:\n\n```text\ncd $HOME/audirvana-docker\n./build-origin.sh\n```\n\nor\n\n```text\ncd $HOME/audirvana-docker\n./build-studio.sh\n```\n\nYou might want to append `--no-cache` to these commands in order to force rebuild without caching.  \nI will not provide pre-built images, in order to avoid to include proprietary binaries.  \nInitially, I tried installing the binaries at container startup time, but then abandoned that road. It worked, but the delay in the startup phase was a bit too long for my taste.  \nAlso, the resulting images could have been uploaded to docker hub, because they would not contain any binaries, but I believe that these would have provided very little advantage compared to the current solution.  \n\n## Usage\n\n### Environment Variables\n\nVARIABLE|DESCRIPTION\n:---|:---\nACCEPT_EULA|You MUST set this to `Y` or `YES`, case insensitive\nBINARY_TYPE|Set it to either `studio` or `origin`\nPUID|The uid for the user you want to run the application, see [User and Group ids](#user-and-group-ids)\nPGID|The gid for the user you want to run the application, see [User and Group ids](#user-and-group-ids)\nAUDIO_GID|The additional gid, should be set to the audio group id, see [User and Group ids](#user-and-group-ids)\nMUSIC_DIRECTORY|The path to be mounted as `/music`, defaults to `./music`\n\n### User and Group ids\n\nGet the current user uid and gid by opening a terminal and entering:\n\n```text\nid\n```\n\nThis should return something like:\n\n```text\nuid=1000(giovanni) gid=1000(giovanni) groups=1000(giovanni),995(audio)\n```\n\nNow you have your uid which is 1000, the gid which is also 1000, and the audio group id which in my case is 995.  \nYour user might not be in the audio group (albeit this is unlikely in a desktop system), in this case you can obtain the group id using the following:\n\n```text\ngetent group audio\n```\n\nAgain in my case, this would return:\n\n```text\naudio:x:995:giovanni,mpd\n```\n\nPlease note the adding the audio group is needed only if you want to use the device's built-in audio capabilities. If you plan the device to just be a server for other UPnP players, the step is not required.  \n\nIf the previous command does not return anything, the alsa libraries might not be installed correctly. Refer to your distro documentation to understand how to install alsa.  \nPlease note that I removed all the additional groups just to make things hopefully more readable.\n\n### Configure\n\nConfigure the application you want to run by copying the `sample.env` file to a `.env` file:\n\n```text\ncp $HOME/audirvana-docker/sample.env $HOME/audirvana-docker/.env\n```\n\nTune the content of the `.env` file according to the previous table and to the information provided in the `sample.env` file.  \n\n### Run\n\nAfter you have built the image you want to run, and created you configuration, simply run the application using the following:\n\n```text\ncd $HOME/audirvana-docker\ndocker-compose up -d\n```\n\nYou can watch the logs using:\n\n```text\ncd $HOME/audirvana-docker\ndocker-compose logs -f\n```\n\n### (A bit more) Advanced\n\n#### Compose file for Studio with builder\n\nBuild and start the Studio version of the application using the following command:\n\n```text\ncd $HOME/audirvana-docker\ndocker-compose -f docker-compose-studio.yaml up --build -d\n```\n\nPlease note that this might trigger an image (re)build, if needed.\n\n#### Compose file for Origin with builder\n\nBuild and start the Studio version of the application using the following command:\n\n```text\ncd $HOME/audirvana-docker\ndocker-compose -f docker-compose-origin.yaml up --build -d\n```\n\nPlease note that this might trigger an image (re)build, if needed.  \n\n### Renderer\n\nYou can easily add a player on mostly any device with audio capabilities using [this example](https://github.com/GioF71/audio-tools/tree/main/players/audirvana-upnp) using my images for [mpd](https://github.com/GioF71/mpd-alsa-docker), [upmpdcli](https://github.com/GioF71/upmpdcli-docker) and [yams](https://github.com/GioF71/yams-docker).  \nCredit to the individual underlying projects can be found on the documentation of each repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiof71%2Faudirvana-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiof71%2Faudirvana-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiof71%2Faudirvana-docker/lists"}