modem7/newyearcountdown repository overview

⁠Docker-NewYearCountdown

Self hosted, self contained countdown clock to the next New Year. Automatically targets the next January 1st based on local system time — no configuration needed, just run it.

⁠Screenshot

See it live: https://modem7.github.io/Docker-NewYearCountdown/⁠

⁠Quick start

docker run -d --name newyearcountdown -p 8080:8080 modem7/newyearcountdown

Or Compose, if that's more your thing:

services:
  newyearcountdown:
    image: modem7/newyearcountdown
    container_name: NewYearCountdown
    ports:
      - 8080:8080

Open http://localhost:8080 and enjoy.

⁠What's actually in the image

• Built on nginxinc/nginx-unprivileged, runs as uid 101. No root, anywhere
• gzip on, plus the usual security headers (X-Content-Type-Options, X-Frame-Options, Referrer-Policy, Content-Security-Policy) — see conf/nginx-site.conf if you want the specifics
• /healthz backs the built-in HEALTHCHECK, so it actually means something
• Multi-arch: amd64, arm/v6, arm/v7, arm64/v8

⁠Testing / CI

Every push/PR touching the image builds it, boots a real container, and pokes at it: page structure, gzip, the security headers, static assets, non-root/no-sudo/no-world-writable-files, and a Playwright script that fakes the browser clock to a few seconds before midnight on New Year's Eve and confirms the countdown actually rolls over to "Happy New Year!". See .github/workflows/test.yml if you want the gory details.

.woodpecker.yml does the actual multi-arch build and Docker Hub push, triggered automatically on push to master (or manually, for on-demand rebuilds).

⁠Tags

⁠Credits

Not my work, I just packaged it up: original creator patrickgold⁠.

⁠License

MIT, see LICENSE⁠.