https://github.com/jangita/docker-raspbian-temp
Small utility to send out the temperature of your Raspberry Pi (running Raspbian) to an external URL. It also posts the host name in case you are monitoring a Raspberry Pi swarm or something cool like that. Works with https://github.com/jangita/docker-raspbian-temp-server
https://github.com/jangita/docker-raspbian-temp
docker raspberry raspberry-pi raspberry-pi-3 raspberry-pi-4 raspberry-pi-zero raspberry-pi-zero-w raspberrypi raspbian temp temperature temperature-monitoring temperature-sensor
Last synced: about 1 month ago
JSON representation
Small utility to send out the temperature of your Raspberry Pi (running Raspbian) to an external URL. It also posts the host name in case you are monitoring a Raspberry Pi swarm or something cool like that. Works with https://github.com/jangita/docker-raspbian-temp-server
- Host: GitHub
- URL: https://github.com/jangita/docker-raspbian-temp
- Owner: jangita
- Created: 2020-10-17T19:53:26.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-11-11T03:01:09.000Z (over 5 years ago)
- Last Synced: 2025-01-22T23:11:24.388Z (over 1 year ago)
- Topics: docker, raspberry, raspberry-pi, raspberry-pi-3, raspberry-pi-4, raspberry-pi-zero, raspberry-pi-zero-w, raspberrypi, raspbian, temp, temperature, temperature-monitoring, temperature-sensor
- Language: Python
- Homepage:
- Size: 25.4 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Docker Raspbian Temp Reporter
## What is this ?
Small utility to send out the temperature of your Raspberry Pi (running Raspbian) to an external URL. It also posts the host name in case you are monitoring a Raspberry Pi swarm or something cool like that.
There is an example express-nodejs-Docker server that can receive this information here https://github.com/jangita/docker-raspbian-temp-server
I have a stable version over at docker here https://hub.docker.com/repository/docker/jangita/raspbian-temp-post
## Why ?
I've always found myself wanting to monitor my Raspberry Pi's temperature remotely. So I'd just run one of these containers in each and presto. Don't have to bother coding. And yes I do work my Pi's hard and install fans and stuff like that, especially for my commercial products. Hopefully it will be of use to you too!
## How do I run it?
Install docker. Check out the documentation here > https://docs.docker.com/engine/install/debian/
The docker page for reference is here https://hub.docker.com/repository/docker/jangita/raspbian-temp-post
To run the version over at Docker hub which is "stable" and I maintain, type
```
docker run -d -v /sys/class/thermal/thermal_zone0/temp:/app/temp -v /etc/hostname:/app/hostname -e POST_SECONDS=10 -e POST_URL="http://docker-raspbian.jangita.io:16111/temp" jangita/raspbian-temp-post:latest
```
To run the version from this repo which is bleeding edge and may break, but has the latest and greatest features, first build from this Github repo then run:
```
docker build -t raspbian-temp-post https://github.com/jangita/docker-raspbian-temp.git
```
when that is done, run
```
docker run -d -v /sys/class/thermal/thermal_zone0/temp:/app/temp -v /etc/hostname:/app/hostname -e POST_SECONDS=10 -e POST_URL="http://docker-raspbian.jangita.io:16111/temp" raspbian-temp-post
```
and it should be up and running.
## Can I configure which URL it POSTs to and how often it POSTs ?
Yes! Just change the environment variables POST_URL and POST_SECONDS which in the above commands points to my test server and 10 seconds. This is how often the temperature is checked and posted and which URL the details are posted to. You can also set them in your docker_compose.yml file and so on. Note that the service does not terminate if the URL is invalid, but it will terminate if the environment variables do not make sense e.g POST every "Chris" seconds 🤣 instead of 20 seconds.
## What format does it POST in?
The information is posted as JSON on the HTTP body like so
```
{
"host": "myraspberry"
"temp": 338459
}
```
The temperature is in millidegrees C milli = thousandths of a degree Celcius - Thanks! French!) so divide by 1000 to give you degrees C and do the nessesary to convert to degrees F or Kelvin if you are feeling scientific 😎
## Contributing
Would greatly appreciate a coffee to put up and maintain more opensource stuff. Buy me one here ☕ https://paypal.me/exoscale
Things to do:
1. Tighten up and lock down the versioning
2. Better logging
As always, all contributions of whatever nature are welcome. Just
1. Fork it!
2. Create your feature branch: `git checkout -b my-new-feature`
3. Commit your changes: `git commit -am 'Add some feature'`
4. Push to the branch: `git push origin my-new-feature`
5. Submit a pull request 😁