# crazy-max/diun

Receive notifications when an image is updated on a Docker registry

Repository: https://github.com/crazy-max/diun
Canonical: https://ross.abutalabs.com/products/diun
Homepage: https://crazymax.dev/diun/
Language: Go
License: MIT
License Family: permissive
Topics: docker, registry, update, watch, notifications, golang, manifest, automation, update-checker, swarm, kubernetes, gotify, telegram, slack, rocketchat, discord, pushover, nomad
Last push: 2026-08-11T13:02:30+00:00

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

## Adoption (not part of the score)
Stars 4881, forks 152 (observed 2026-08-28T04:09:01.803096+00:00)

## What it is
Diun (Docker Image Update Notifier) is a Go tool that watches container images on Docker registries and notifies you when a tracked tag or digest changes. It runs as a single binary or Docker container, discovers images from Docker, Containerd, Kubernetes, Swarm, Nomad, Dockerfile, or file providers, and sends alerts via Slack, Telegram, Gotify, email, and many other channels.

## Use cases
- get notified when a docker image is updated
- track container image tag changes on a registry
- monitor base image updates for self-hosted services
- watch kubernetes or swarm images for new digests
- schedule automatic registry checks without cron
- send image update alerts to slack or telegram

## When to choose
- you self-host containers and need to know when upstream images change
- you want scheduled registry checks with multi-platform notification support
- you need image update tracking across Docker, Kubernetes, Swarm, Nomad, or Containerd

## When to avoid
- you want a tool that automatically pulls and applies image updates rather than just notifying (use Watchtower)
- you need vulnerability scanning of images rather than update detection
- you don't run any container workloads

## Facets
- artifact type: service
- maturity: active
- function: monitoring, alerting, workflow-automation, scheduling, webhook, developer-tools
- domain: self-hosted, monitoring
- platform: windows, self-hosted, cli, go
- tags: docker-image-update-notifier, container-registry, watcher, notifications, image-digest, prometheus-metrics, systemd-service, devops, containers, automation, linux, macos, docker, kubernetes

## Member repositories
- crazy-max/diun (main) score 85

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:01.803096+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-29T18:18:16.018672+00:00, confidence not recorded.
  - readme: https://github.com/crazy-max/diun (fetched 2026-08-28T04:09:01.803096+00:00, sha c15555cb86c6)
  - homepage: https://crazymax.dev/diun/ (fetched 2026-08-29T09:00:41.526700+00:00, sha 442a13e2048b)
  - site_page: https://crazymax.dev/diun/install/docker (fetched 2026-08-29T09:00:41.535697+00:00, sha 2cd8274d728a)
  - site_page: https://crazymax.dev/diun/install/binary (fetched 2026-08-29T09:00:41.537684+00:00, sha 8047b06996b1)
  - site_page: https://crazymax.dev/diun/install/linux-service (fetched 2026-08-29T09:00:41.539317+00:00, sha 22dc362b226c)
  - site_page: https://crazymax.dev/diun/faq (fetched 2026-08-29T09:00:41.540792+00:00, sha c882e522f216)
  - site_page: https://crazymax.dev/diun/changelog (fetched 2026-08-29T09:00:41.543086+00:00, sha 4b848bb66aad)
- Data as of 2026-08-30T08:39:29.467469+00:00.