"HamClock is a kiosk-style application that provides real time space weather, radio propagation models, operating events and other information particularly useful to the radio amateur." (Source: Hamclock Website)
Goal of this repository is to build and run Hamclock inside Docker for ease of use. Hamclock will be exposed as a webservice on http://localhost:8081/live.html
This repository does NOT contain any Hamclock source files as it's neither neccessary nor is the licensing clear. The files will be downloaded and compiled during docker build
.
More information and documentation on the Hamclock Website: https://www.clearskyinstitute.com/ham/HamClock/
I assume that you're on some form of Linux/Unix system. Docker and (optionally) Docker Compose are installed. This may or may not work inside Windows WSL2 environment. I've not tested it and most likley will. Please give feedback if you tested this. :)
As of now, i don't have a raspbery Pi. WB0OEW gave me the feedback, that the docker-compose
variant doesn't work on his Pi4, we're going to work that out.
- Check out this repository and change into it
- Copy the
config_example.env
toconfig.env
and edit to your liking - Inside the repository, run
docker build -t hamclock .
- Run Hamclock using
docker run --rm --name hamclock -d -it -p 8081:8081 -p 8080:8080 --env-file config.env hamclock
- Enjoy WB0OEW's hard work on http://localhost:8081/live.html
- To stop Hamclock, run
docker stop hamclock
- Check out this repository and change into it
- Copy the
config_example.env
toconfig.env
and edit to your liking - Inside the repository, run
docker-compose up -d
- Enjoy WB0OEW's hard work on http://localhost:8081/live.html
- To stop Hamclock, simply run
docker-compose down
- Clone this repo
git clone https://github.com/zeidlos/hamclock-docker.git
- Change directory into the repo
cd hamclock-docker
- Copy the
config_example.env
toconfig.env
and edit to your liking - Build the Docker image for the Dockerfile with this commad
docker build -t hamclock:latest
- Run the container with this command
docker-compose -f docker-compose.hybrid.yml up -d
you can change the ports, docker network, and other things you may need by editing the docker-compose.hybrid.yml file
ex: with the port changed to 9500 the address to access hamclock will be http://localhost:9500/live.htmlAlso note that if you change the port that the container is using you will need to change the address to access Hamclock
At this point I assume you have deeper knowledge on how to use Docker and potentially Kubernetes as well as reverse proxies, so I won't bother to explain the myriad of options on how to get it to run on remote infrastructure.
(x) Intel based MacOS (x) Silicon based MacOS (x) Intel based Linux (Debian) (?) Rasbian (?) Windows WSL2
Please let me know if you encounter any issues or problems. Ideally you include your operating system, architecture (Intel, AMD, Atom, Apple Silicon M1/2) as well as the software versions of docker and docker compose in your ticket. I'll gladly assist in any issues. You can also email me, using the email address on my QRZ-page (DO7JZ).
If you're interested in advancing this, please use the usual workflow of forking and creating a pullrequest.
Chris thought this project is not maintained anymore and did want to try a different approach. If this doesn't work for you maybe give his project a try: https://github.com/ChrisRomp/hamclock-docker
Customize Hamclock configuration via config file
Initial release.
- Make it work on Raspbian as well.
- Customize target resolution in build process.
Thanks to WB0OEW for his great ham radio tool! 73