Docker

Note: radiosonde_auto_rx is not available through Docker Hub at this time, and must instead be built locally.

The RTL DVB kernel modules must be blacklisted on the Docker host. RTL-SDR itself is not required on the Docker host.

Build the container image

cd ~
git clone https://github.com/projecthorus/radiosonde_auto_rx.git
cd radiosonde_auto_rx
docker pull debian:buster-slim
docker build --rm -t radiosonde_auto_rx .

Update the container image

cd ~/radiosonde_auto_rx/
git checkout master
git pull
docker pull debian:buster-slim
docker build --rm --no-cache -t radiosonde_auto_rx .

Substitute ~/radiosonde_auto_rx/ with the local path to the radiosonde_auto_rx Git repository.

After updating the container image, to use the new image, the existing container needs to be stopped and removed, and a new container run.

Run the container

docker run -d --name radiosonde_auto_rx --restart="unless-stopped" --device=/dev/bus/usb -v ~/radiosonde_auto_rx/auto_rx/station.cfg:/opt/auto_rx/station.cfg:ro -v ~/radiosonde_auto_rx/auto_rx/log:/opt/auto_rx/log -p 5000:5000 radiosonde_auto_rx

Alternatively, to launch the container directly in to an interactive shell rather than a daemonised auto_rx.py:

docker run --rm -it --name radiosonde_auto_rx --device=/dev/bus/usb -v ~/radiosonde_auto_rx/auto_rx/station.cfg:/opt/auto_rx/station.cfg:ro -v ~/radiosonde_auto_rx/auto_rx/log:/opt/auto_rx/log -p 5000:5000 radiosonde_auto_rx /bin/bash

Substitute ~/radiosonde_auto_rx/auto_rx/station.cfg and ~/radiosonde_auto_rx/auto_rx/log in the above commands with the relevant local paths, ensuring that station.cfg has been created as appropriate.

--restart="unless-stopped" will result in the container automatically restarting after a failure or host system reboot.

Once running, you can access the Web UI through http://<docker-host>:5000.

Restart the container

Restarting the container is useful for picking up changes to station.cfg.

docker restart radiosonde_auto_rx

Stop the container

docker stop radiosonde_auto_rx

Remove the container

docker rm radiosonde_auto_rx

View the containers logs

All logs

docker logs radiosonde_auto_rx

Last 50 lines

docker logs --tail 50 radiosonde_auto_rx

Follow the logs in real-time

docker logs --follow radiosonde_auto_rx

Open a shell within an existing running container

docker exec -it radiosonde_auto_rx /bin/bash