Docker

Initial support for running radiosonde_auto_rx inside a Docker container is now available in the testing branch.

This 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 -b testing https://github.com/projecthorus/radiosonde_auto_rx.git
cd radiosonde_auto_rx
docker build --rm -t radiosonde_auto_rx .

Update the container image

cd ~/radiosonde_auto_rx/
git checkout testing
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