whatisgithub

What is diun?

crazy-max/diun — explained in plain English

Analysis updated 2026-06-26

4,653GoAudience · ops devopsComplexity · 2/5LicenseSetup · moderate

In one sentence

Watches your Docker container images in the background and sends a notification whenever a new version or update is available in the registry, so you never run outdated containers.

Mindmap

mindmap
  root((diun))
    What it does
      Watch image registries
      Detect new versions
      Send notifications
    Discovery methods
      Running containers
      Kubernetes clusters
      Compose files
      Manual image list
    Notification channels
      Discord
      Slack
      Gotify
    Tech
      Go
      Self-hosted
      Docker
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get a Slack or Discord alert whenever a Docker image your server uses releases a new version

USE CASE 2

Keep Kubernetes workloads current by watching all running container images for registry updates

USE CASE 3

Monitor private registry images that require authentication alongside public Docker Hub images

USE CASE 4

Scan a Docker Compose file and automatically watch every image listed in it for updates

What is it built with?

GoDockerKubernetes

How does it compare?

crazy-max/diuncdk-team/cdkopen-telemetry/opentelemetry-collector-contrib
Stars4,6534,6544,654
LanguageGoGoGo
Setup difficultymoderateeasymoderate
Complexity2/54/54/5
Audienceops devopsops devopsops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires configuring registry credentials and at least one notification service before alerts will work.

Use, modify, and distribute freely for any purpose, as long as you keep the copyright notice.

So what is it?

Diun is a tool that watches Docker container images and notifies you when updates are available. When you run software using containers, those containers are built from base images that get updated over time, sometimes with new features, sometimes with security fixes. Without something like Diun, you would need to check each image registry manually to see whether a newer version exists, which is easy to forget and easy to fall behind on. Diun runs in the background and periodically polls the container registries where your images are hosted. When it detects a new tag or a change in an image digest (a fingerprint that changes whenever the image content changes), it sends you a notification. This works with a range of notification services including Discord, Gotify, Slack, and others, so you can route alerts to whatever you already use for operations. The tool supports several ways of discovering which images to watch. It can monitor Docker containers currently running on a host, watch Kubernetes clusters, read Compose files, or work from a list of images you specify manually. This means it fits into many different infrastructure setups without requiring major changes. Installation is straightforward: run Diun as a standalone binary or as a Docker container itself. A configuration file lets you set the polling schedule, define which registries to check, and specify how to authenticate with private registries that require credentials. Diun is written in Go and released under the MIT license. It is self-hosted, meaning you run it on your own machines rather than relying on an external service.

Copy-paste prompts

Prompt 1
Write a Diun configuration file that watches all running Docker containers on my host and sends a notification to Discord when any image gets an update.
Prompt 2
Help me configure Diun to monitor a private container registry that requires a username and password, running Diun itself as a Docker container.
Prompt 3
I use Kubernetes. Write a Diun config that watches all container images across my cluster and notifies me via Slack when updates are available.
Prompt 4
My Diun config uses a Compose file as a provider. Show me how to filter so Diun only watches images tagged as latest.

Frequently asked questions

What is diun?

Watches your Docker container images in the background and sends a notification whenever a new version or update is available in the registry, so you never run outdated containers.

What language is diun written in?

Mainly Go. The stack also includes Go, Docker, Kubernetes.

What license does diun use?

Use, modify, and distribute freely for any purpose, as long as you keep the copyright notice.

How hard is diun to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is diun for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.