Skip to content

thebigbone/docker-rss

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

About

docker-rss is a server written in Go which notifies the image updates using an RSS feed at /feed.

There are quite a lot of image updater projects such as watchtower, duin and a few more.

Unfortunately, none of them provide an RSS feed which I mainly use for keeping track of all the updates to the software that are critical for my homelab and workflow. Therefore I made this tiny program.

Deploy

Currently, the way it detects the updates is by first mounting the /var/run/docker.sock socket on the docker-rss container which will then detect all the running containers and thereby schedule the image update scans from dockerhub.

A ready-to-use docker-compose.yaml is available with only one environment variable to worry about: UPDATE_SCHEDULE.

UPDATE_SCHEDULE is your regular cron expression which can be adjusted accordingly.

Start the container:

docker compose up -d

After the server starts, add it as a feed to your favorite RSS reader. Add the /feed at the end of the URL, that's where the feeds are published.

TODO

  • support different registries
  • properly detect images which are local only
  • write tests
  • ...

License

MIT. See LICENSE for more details.

About

an rss feed for docker image updates

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published