mag37

Dockheck is a CLI tool to automate docker image updates. Interactively or unattended with notifications, image backups, exclude/include, labels, autoprune and more. Can be run as is, without configuration or with extensive options.

This year my AFK-life have been intense, so development have been slow and mainly squashing bugs. But others have kept contributed with suggestions on improvements, ideas on new features and some ready to merge patches.
So these last couple of weeks I've tried to squeeze in some time to bring it together in v0.8.0 and now v0.8.1.

New stuff in short:

Docker Compose -ready:

• Now possible to run dockcheck within its own docker compose container (or docker run).
• Easily set up your notifications and options, either in conf-file or env-vars, then let it run as any other container.
• Optionally run it once interactively with docker run, no need for configs.
• Run interactively between your scheduled compose setup with docker exec -it as usual.

New options:

• -N No updates or checks; simulating updates to test notifications unconditionally.
• -E Exclude containers from applying updates but check available, separated by comma.
• -C Temporarily use default configs - override dockcheck.config file.
• -o Hides the "No updates available" message and only shows updateable images.

New notification templates:

• Home Assistant Event Integration
• XMPP
• Bark

I'm very happy this project still got traction considering all the large alternatives around. Wonderful community!

Disclaimer: No AI tools used what so ever from my end and encouraging contributors to refrain and/or explain.

[CBH]

I just has the honors of writing a guest article on selfh.st about my ever so slowly evolving project, dockcheck.

Another few months have passed and thanks to a of user contributions and suggestions a bunch of changes got implemented, big and small.
The two latest changes have been pretty large:

• Complete rewrite of notification logics
  • Configuration is set through the dockcheck.config
  • Templates used "untouched"
  • Possibility to trigger multiple notification templates through "channels"
• Restructure the update process
  • First pulls all (selected) images
  • Then recreate all containers that received updates - to avoid unnecessary restarts and strain

https://github.com/mag37/dockcheck

Plenty more changes have been implemented since I posted last, such as:

• Added a config-file to set user options (same as passing option flags).
• Added option -u for unattended dockcheck self update (caution!).
• Added option -I to print urls from url.list to list of containers with updates.
• Cleaned up and refactored a lot of code;
  • Safer variables and pipefail options.
  • Consistent colorization of messages.
  • Monochrome mode hides progress bar.
  • Exits if pull or recreation of container fails.
• Cleared up some readme with extra info;
  • Synology DSM
  • Prometheus + node_exporter
  • Zabbix config
  • Rest API script
  • Unraid wrapper script
• Permission checks;
  • Graceful exit if no docker permissions.
  • pkg-manager installs handles sudo/doas/root properly.
• Notify-templates; added slack, added markdown support to some templates.

I'm very happy to have a supportive and contributing user base who helps with troubleshooting, suggesting changes and contributing code. Thank you!

dockcheck is simple CLI tool to simplify keeping track of and updating your containers. Selective semi/fully auto updates, notifications on new versions and much more.

Another 6 months have passed and a bunch of updates have been made. The most recent ones are multi-threaded/asynchronous checks to greatly increase speed, notifications on new dockcheck release for those who run scheduled unattended checks, osx and bsd compatibility changes, prometheus exporter to push stats to eg. Grafana and more.

I'm happy to see the project still being used and improved by its users as I thought other great tools (dockge, wud, watchtower and others) would replace it.

As it's been a while I'll try to list the features:

• Checks all your containers for new updates, without pulling.
• Manually select which containers or choose all.
• Either run it to auto update all, or not update any and just list results.
• Tie it to notify you on new updates.
  • Templates: Synology DSM, mSMTP, Apprise, ntfy.sh , Gotify , Pushbullet , Telegram , Matrix, Pushover , Discord.
  • Enrich with urls to container release notes.
• Optionally export metrics to Prometheus to show how many images got updates available in a graph.
• Other misc options as:
  • Use labels to only update containers with label set.
  • Use a N days old option to only update images that have been stable release N days.
  • Auto prune dangling images.
  • Include stopped containers.
  • Exclude specific containers.

I've got to thank this community for contributing with donations, ideas, surfacing issues, testing and PRs. It's a joy!