The standard Pi-hole customization abilities apply to this docker, but with docker twists such as using docker volume mounts to map host stored file configurations over the container defaults. Volumes are also important to persist the configuration in case you have removed the Pi-hole container which is a typical docker upgrade pattern. Verify the Docker version root@node2:/home/pi# docker version Client: Version: 18.09.0 API version: 1.39 Go version: go1.10.4 Git commit: 4d60db4 Built: Wed Nov 7 00: OS/Arch: linux/arm Experimental: false Server: Docker Engine - Community Engine: Version: 18.09.0 API version: 1.39 (minimum version 1.12) Go version: go1.10.4 Git. The good news is that Raspberry Pi OS does support Docker, in both the 32-bit and 64-bit variants! Read below on how to install it as well as Docker Compose. Note: This article is written for Raspberry Pi 2, 3 and 4 running Rasperry Pi OS. Older models of the board and Raspberry Pi Zero are currently not supported.

Docker Installation

This page describes how to run the official Airsonic Docker image.

Prerequisites

In order to install and run Airsonic using Docker, a working installation of Docker is required.

If you do not have Docker installed, you may follow these instructions to install it on your system.

Verify that Docker is installed by running

Running Airsonic

Running the Airsonic Docker container is straight forward. Simply execute the command below.

You should be able to access Airsonic on http://localhost:4040 after a couple of seconds.

When running Docker this way all changes you make to Airsonic will be lost when stopping the container. Use Volumes to persist data when the container is stopped.

Persisting Data

The Airsonic Docker file provides various mount points for volumes. You can see which by checking out the Dockerfile.

Docker Pip3

Attach volumes to your docker container when starting the container like so:

You can find additional information regarding volumes here. Inspect volumes by running, for example docker volume inspect data.

Docker Pip Install

Advanced Configuration

Docker Pi-hole

Configuring Airsonic is best done using the web-interface.

Docker Ping Container

Regardless, you may at one point wish to configure Airsonic using the properties file.

You may adjust the airsonic.properties file directly. You can find it in the data volume that was attached to the container. Before making any changes to the file make sure that the Airsonic container is stopped.

Docker Pip

If you did not supply another volume mountpoint the file will reside in /var/lib/docker/volumes/data/_data. You need administrator rights to modify it.

Another way to configure Airsonic is by passing start-up arguments to the container when executing docker run. You may use the environment variable JAVA_OPTS to pass properties to Airsonic.

Docker Pi Power Board

View the docker container start-up script for additional information.