Repolode
mag37

mag37/dockcheck

CLI em Bash que verifica se há imagens mais recentes para contêineres Docker e os atualiza de forma interativa ou automática, com notificações, backups de imagens e autoprune.

Alternativa open source a:Watchtower

Estrelas
2,543
Forks
96
Issues abertas
9
Último commit
há 24 dias

O que é?

dockcheck é um script de shell que compara as imagens usadas pelos contêineres Docker em execução com as disponíveis nos respectivos registries e informa quais têm versões mais recentes. Você pode escolher interativamente quais contêineres atualizar ou executá-lo sem interação pelo cron, com filtros para inclusão, exclusão e seleção por labels.

Além das verificações básicas de atualização, ele pode manter backups das imagens anteriores com novas tags para permitir rollback, remover imagens dangling após as atualizações e enviar notificações por vários canais, como ntfy, Gotify, Telegram, Slack, Discord, Home Assistant e Apprise. Também oferece suporte a stacks do Docker Compose, exportação de métricas do Prometheus e uma opção para verificar atualizações sem fazer o pull das imagens.

Ele requer Bash 4.3 ou posterior, jq e regctl, e foi projetado para hosts Docker, como servidores de homelab. Este projeto não oferece suporte a Podman; há um fork separado para isso.

Recursos principais

  • 01Seleção interativa ou atualização totalmente automática de contêineres Docker
  • 02Filtros de contêineres por inclusão, exclusão e labels
  • 03Backups de imagens com novas tags para facilitar o rollback e limpeza com base na idade
  • 04Notificações por vários canais, incluindo ntfy, Telegram, Slack e Home Assistant
  • 05Suporte a Docker Compose e opção de implantação em contêiner
  • 06Exportação de métricas do Prometheus pelo coletor textfile do node_exporter

Casos de uso

  • Manter os serviços Docker auto-hospedados de um homelab atualizados em uma programação definida
  • Receber notificações sobre atualizações disponíveis para contêineres sem aplicá-las automaticamente
  • Reverter um contêiner para a imagem anterior após uma atualização com problemas
  • Monitorar atualizações de imagens pendentes pelo Prometheus ou Zabbix

Início rápido

  1. 1

    Baixe o script para ~/.local/bin com curl

    curl -L https://raw.githubusercontent.com/mag37/dockcheck/main/dockcheck.sh -o ~/.local/bin/dockcheck.sh
  2. 2

    Torne o script executável

    chmod +x ~/.local/bin/dockcheck.sh
  3. 3

    Execute o script para verificar se há atualizações de contêineres

    dockcheck.sh

Antes de usar

  • Requer Bash 4.3 ou mais recente, jq e Docker em execução com compose.
  • Foi escrito em Bash, então só funciona em shells semelhantes ao Linux; o Podman precisa de um fork separado.

Em coleções

Tópicos

Perguntas frequentes

O que é dockcheck?
CLI em Bash que verifica se há imagens mais recentes para contêineres Docker e os atualiza de forma interativa ou automática, com notificações, backups de imagens e autoprune. dockcheck é um script de shell que compara as imagens usadas pelos contêineres Docker em execução com as disponíveis nos respectivos registries e informa quais têm versões mais recentes. Você pode escolher interativamente quais contêineres atualizar ou executá-lo sem interação pelo cron, com filtros para inclusão, exclusão e seleção por labels.
dockcheck é gratuito? Qual é a licença?
dockcheck é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
dockcheck ainda é mantido?
Manutenção ativa. O último commit de dockcheck foi em 14 de out. de 2026.
Para que posso usar dockcheck?
Manter os serviços Docker auto-hospedados de um homelab atualizados em uma programação definida Receber notificações sobre atualizações disponíveis para contêineres sem aplicá-las automaticamente Reverter um contêiner para a imagem anterior após uma atualização com problemas Monitorar atualizações de imagens pendentes pelo Prometheus ou Zabbix
Como instalar dockcheck?
Baixe o script para ~/.local/bin com curl: curl -L https://raw.githubusercontent.com/mag37/dockcheck/main/dockcheck.sh -o ~/.local/bin/dockcheck.sh Torne o script executável: chmod +x ~/.local/bin/dockcheck.sh Execute o script para verificar se há atualizações de contêineres: dockcheck.sh
Onde consigo dockcheck?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mag37/dockcheck

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados

Ferramenta self-hosted que monitora containers em execução no Docker, Swarm, Kubernetes, Compose e Nomad, identifica versões mais recentes de imagens e pode notificar ou atualizá-los automaticamente.

DevOps e nuvem#docker#container-updates#kubernetes
4,2 mil+55 esta semana163TypeScriptMITBem mantidoAtualizado há 9 horas