Español · Українська

Doomsday Clock Exporter

Prometheus exporter that scrapes the Bulletin of the Atomic Scientists Doomsday Clock value and exposes it as a gauge of seconds to midnight. A background scraper caches the value with a configurable TTL, serves stale values with a degradation gauge on upstream failure, and retries with exponential backoff.

Features

• Cached scraping with graceful degradation
• Environment variable configuration
• Service-specific healthcheck
• Average and median age of the people with launch authority
• Self-observability metrics

It also inherits the features of B19 / Ubuntu — see Features for the full list.

Quick Start

Save this as compose.yaml:

---
services:
  doomsday-clock-exporter:
    image: docker.io/damianbuho/doomsday-clock-exporter:latest
    ports:
      - "8080:8080"
    cap_drop: [ALL]
    security_opt: [no-new-privileges:true]
    restart: unless-stopped

Then start it with docker compose up --detach.

What this provides

• Service exporter — listens on 8080 (metrics) — Prometheus metrics endpoint
• Executable doomsday-clock-exporter — command doomsday-clock-exporter
• Container image ghcr.io/damian-buho/doomsday-clock-exporter:latest
• Container image damianbuho/doomsday-clock-exporter:latest

Installation

Container image

Pull the published container image:

Pull from GHCR — linux/amd64, linux/arm64, linux/riscv64

docker pull ghcr.io/damian-buho/doomsday-clock-exporter:latest

Pull from DockerHub — linux/amd64

docker pull damianbuho/doomsday-clock-exporter:latest

Stable releases also publish X.Y.Z, X.Y and X tags — pull the precision you want to pin.

If the registries above are unreachable, pull from the origin instead:

Pull from Kiota — linux/amd64

docker pull kiota.ch/damian-buho/doomsday-clock-exporter:latest

Prebuilt binary

Download the prebuilt binary for your platform from GitHub Releases:

mkdir -p ~/.local/bin
curl --fail --location --output ~/.local/bin/doomsday-clock-exporter https://github.com/damian-buho/doomsday-clock-exporter/releases/latest/download/doomsday-clock-exporter-linux-$(uname -m)
chmod +x ~/.local/bin/doomsday-clock-exporter
~/.local/bin/doomsday-clock-exporter --help

Published for: linux/amd64, linux/arm64, linux/riscv64

To uninstall, delete that one file: rm ~/.local/bin/doomsday-clock-exporter.

Usage

Run the service in the background, publishing its ports:

From GHCR

docker run --detach --publish 8080:8080/tcp ghcr.io/damian-buho/doomsday-clock-exporter:latest

From DockerHub

docker run --detach --publish 8080:8080/tcp damianbuho/doomsday-clock-exporter:latest

Then check that it answers:

curl http://localhost:8080/metrics

Building

Clone the repository with its submodules:

git clone --recurse-submodules https://codeberg.org/damian-buho/doomsday-clock-exporter doomsday-clock-exporter && cd doomsday-clock-exporter

Build the container image locally:

make container-build

• Makefile reference

Run make with no arguments for the default target; run make help to list every target.

For the local dev loop, make dev-container brings up the dev-container.

Pipeline entry points:

• make analyzed — Run the heavy analysis sweep (mutation testing, benchmarks)
• make audited — Re-scan the pinned dependencies and published artifacts for new vulnerabilities
• make check-outdated — Report every pinned dependency that lags upstream
• make release-is-ready — Run the pseudo-CI pipeline locally — build, test and scan, without publishing

Policies

• How to contribute
• Security policy
• Getting support
• Code of Conduct
• AI and LLM Policy

Links

• Projectfile Specification

License

This project is licensed under MIT — see the LICENSE file for details.