Skip to content

v1.12.0 — Telegram optional, headless mode

Choose a tag to compare

@amayer1983 amayer1983 released this 01 May 16:13
· 61 commits to main since this release

Highlights

Telegram is now optional. Docksentry can run fully headless with just the Web UI, just Discord, just a generic webhook, or any combination. BOT_TOKEN / CHAT_ID are no longer required.

This was requested by @hypnosis4u2nv in #2.

Added

  • Headless mode — leave BOT_TOKEN/CHAT_ID unset and Docksentry runs without Telegram. At least one of WEB_UI=true, DISCORD_WEBHOOK, WEBHOOK_URL must be configured (validated at startup).
  • Web UI: Image Cleanup button — runs docker image prune on demand from the Settings page. Was previously only reachable via Telegram /cleanup.
  • Web UI: Self-Update button — triggers a self-update from the Settings page. Was previously only reachable via Telegram /selfupdate.
  • Settings page: Telegram status row — shows whether Telegram is enabled or disabled (headless) at a glance.

Changed

  • Pin / auto-update state extracted into a new container_store.py module. The Web UI now reads/writes these lists directly, so they keep working in headless mode.
  • Startup output now reports Telegram: ON / OFF clearly.

Migration

  • Existing setups with BOT_TOKEN + CHAT_ID continue to work unchanged.
  • To go headless: remove BOT_TOKEN and CHAT_ID from your environment, keep WEB_UI=true (and/or DISCORD_WEBHOOK / WEBHOOK_URL).

Quickstart — headless

docker run -d \
  --name docksentry \
  --restart unless-stopped \
  -e WEB_UI=true \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  amayer1983/docksentry:latest

Upgrade

docker pull amayer1983/docksentry:latest
docker compose up -d