Open Source · MIT License

Gerenciamento automatico
de containers Docker

Mantendo seus containers no rumo certo.

Monitore, atualize e proteja containers Docker com automacao completa, interface web e CVE scan integrado.

docker run -d -p 8080:8080 -v /var/run/docker.sock:/var/run/docker.sock ghcr.io/luiscruzcwb/timoneiro
localhost:8080/containers
12 Containers
9 Atualizados
2 Pendentes
0 Falhas
nginx 1.27.4 up-to-date
postgres 17.3 → 17.4 disponivel
redis 7.4.2 up-to-date
traefik 3.2.1 → 3.3.0 disponivel
grafana 11.4.0 up-to-date

Tudo que voce precisa

Projetado para ser simples de instalar e poderoso em producao.

Interface web completa

Dashboard com status em tempo real via WebSocket, historico de atualizacoes, aprovacao manual e rollback com um clique. Sem linha de comando necessaria para o dia a dia.

Leve

Binario unico em Go, imagem Docker abaixo de 30 MB. Roda confortavelmente em um Raspberry Pi.

Multi-ambiente

Monitore hosts Docker remotos via TCP, socket Unix ou agente Timoneiro leve. Toda a infraestrutura em um painel.

Registries privados

Docker Hub, GHCR e qualquer registry OCI: Harbor, Nexus, Gitea. Credenciais armazenadas localmente.

Notificacoes

Discord, Telegram, Slack, SMTP, Gotify, ntfy e qualquer servico Shoutrrr. Multiplos canais simultaneos.

CVE scan

Integracao com Trivy para detectar vulnerabilidades em novas versoes antes de aplicar atualizacoes.

Politicas de atualizacao

Modos Manual, Automatico e Agendado. Janelas de manutencao por dia e horario. Excecoes por container ou por stack Compose. Nenhuma atualizacao surpresa em producao.

API REST + WebSocket

API completa para automacao e integracao com pipelines CI/CD. WebSocket para eventos em tempo real. O mesmo endpoint que a interface web usa.

# Listar containers com atualizacoes disponíveis
GET /api/containers?status=update_available

# Receber eventos em tempo real
WS ws://localhost:8080/ws
"type": "update.available", "container": "postgres"

Em funcionamento em minutos

Sem configuracao complexa. Aponte para o socket Docker e pronto.

1

Instale o Timoneiro

Execute com Docker Run ou Compose. Monte o socket do Docker e um volume para persistencia.

docker run -d \ --name timoneiro \ -p 8080:8080 \ -v /var/run/docker.sock:/var/run/docker.sock:ro \ -v timoneiro_data:/data \ ghcr.io/luiscruzcwb/timoneiro
2

Acesse a interface

Abra http://localhost:8080 no navegador. O Timoneiro descobre automaticamente todos os containers em execucao.

3

Configure as politicas

Escolha o modo de atualizacao (Manual, Automatico ou Agendado), defina janelas de manutencao e configure os canais de notificacao.

4

Relaxe

O Timoneiro monitora seus registries e mantém seus containers atualizados, ou te avisa quando ha algo novo para revisar.

Pronto para
comecar?

Open source, gratuito, sem dependencias externas.