# mag37/dockcheck

CLI tool to automate docker image updates. Interactive or unattended with notifications, image backups, autoprune, no pre-pulling and more.

Repository: https://github.com/mag37/dockcheck
Canonical: https://ross.abutalabs.com/products/dockcheck
Homepage: https://mag37.org
Language: Shell
License: GPL-3.0
License Family: copyleft
Topics: bash, docker, homelab, self-hosted
Last push: 2026-08-11T09:15:56+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 96, longevity 94
- inputs: {"age_days": 1323, "days_push": 22, "days_rel": 29, "gap_med": 12, "n_releases_24m": 34}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2490, forks 95 (observed 2026-08-28T04:06:55.872092+00:00)

## What it is
dockcheck is a Bash CLI tool that checks running Docker containers for newer image versions and can update them automatically, without pre-pulling images. It supports interactive or unattended operation with notifications, image backups, include/exclude lists, autoprune, and Home Assistant integration.

## Use cases
- check which docker containers have image updates without pulling
- automatically update docker containers via cron
- get notified when docker image updates are available
- backup old docker images before updating containers
- prune old docker images after updating
- unattended docker image updates for homelab

## When to choose
- you run Docker on a homelab or server and want lightweight shell-based update automation
- you want update checks without consuming Docker Hub pull limits
- you need notifications (Apprise, Home Assistant, etc.) when updates are available or applied

## When to avoid
- you use Podman instead of Docker (use the podcheck fork)
- you need full orchestration-level rolling updates across a cluster (use Watchtower alternatives or Kubernetes tooling)
- you need a GUI or web dashboard for container management

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, deployment, workflow-automation, container-runtime
- domain: self-hosted
- platform: cli, self-hosted
- tags: docker-image-updates, bash, homelab, container-updates, notifications, autoprune, notification, devops, containers, automation, linux, docker

## Member repositories
- mag37/dockcheck (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:55.872092+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:27:49.403592+00:00, confidence not recorded.
  - readme: https://github.com/mag37/dockcheck (fetched 2026-08-28T04:06:55.872092+00:00, sha 57b85d1e59be)
  - homepage: https://mag37.org (fetched 2026-08-29T10:09:40.234009+00:00, sha f984cea72950)
  - site_page: https://mag37.org/about (fetched 2026-08-29T10:09:40.242997+00:00, sha 908436f34d7a)
- Data as of 2026-08-30T08:39:29.467469+00:00.