Open Source · MIT License

Automatic management
of Docker containers

Keeping your containers on course.

Monitor, update, and secure Docker containers with full automation, a web UI, and integrated CVE scanning.

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 Up to date
2 Pending
0 Failures
nginx 1.27.4 up-to-date
postgres 17.3 → 17.4 available
redis 7.4.2 up-to-date
traefik 3.2.1 → 3.3.0 available
grafana 11.4.0 up-to-date

Everything you need

Designed to be simple to install and powerful in production.

Full web UI

Dashboard with real-time status via WebSocket, update history, manual approval, and one-click rollback. No command line needed for day-to-day use.

Lightweight

Single Go binary, Docker image under 30 MB. Runs comfortably on a Raspberry Pi.

Multi-environment

Monitor remote Docker hosts via TCP, Unix socket, or a lightweight Timoneiro agent. Your whole infrastructure in one dashboard.

Private registries

Docker Hub, GHCR, and any OCI registry: Harbor, Nexus, Gitea. Credentials stored locally.

Notifications

Discord, Telegram, Slack, SMTP, Gotify, ntfy, and any Shoutrrr-supported service. Multiple channels at once.

CVE scanning

Trivy integration to detect vulnerabilities in new versions before applying updates.

Update policies

Manual, Automatic, and Scheduled modes. Maintenance windows by day and time. Exceptions per container or per Compose stack. No surprise updates in production.

REST API + WebSocket

A full API for automation and CI/CD pipeline integration. WebSocket for real-time events. The same endpoint the web UI uses.

# List containers with updates available
GET /api/containers?status=update_available

# Receive real-time events
WS ws://localhost:8080/ws
"type": "update.available", "container": "postgres"

Up and running in minutes

No complex configuration. Point it at the Docker socket and you're done.

1

Install Timoneiro

Run it with Docker Run or Compose. Mount the Docker socket and a volume for persistence.

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

Open the dashboard

Open http://localhost:8080 in your browser. Timoneiro automatically discovers every running container.

3

Configure policies

Choose the update mode (Manual, Automatic, or Scheduled), define maintenance windows, and set up notification channels.

4

Relax

Timoneiro watches your registries and keeps your containers up to date, or lets you know when there's something new to review.

Ready to
get started?

Open source, free, no external dependencies.