Tugtainer-Agent

Tugtainer Agent is the companion agent for Tugtainer, a self-hosted application that automates the checking for and updating of your Docker containers.

  • Infrastructure
  • Network Services
  • Other
  • Productivity
  • Tools & Utilities
Tugtainer Agent is the companion agent for Tugtainer, a self-hosted application that automates the checking for and updating of your Docker containers. It is aimed at homelab and server operators who want safe, opt-in container updates with healthcheck monitoring, private-registry support, and notifications.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

62/100 Good

Maintained
100last commit 21 days ago
Popular
641,549 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
103 serious findings, 9 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 49 days ago

GitHub stars
1,549
Open issues
1
Last commit
2026-10-30
Latest release
v1.45.1
License
MIT
Activity
declining

Checked 20 days ago - source: GitHub (Quenary/tugtainer)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Start the backend and agent services Run `python -m backend.dev` and `python -m agent.dev` in separate terminal windows. The backend and agent are separate pieces, and if one isn't running the app won't be able to manage containers. source
  • Create a .env and set security settings Copy `.env.example` to `.env` and set values like `AGENT_SECRET`; keep `ALLOW_EXEC=false` unless you truly want the agent to run shell commands inside containers. If you leave `ALLOW_EXEC` enabled, a mistaken or bad request can run arbitrary commands in your containers. source
  • Public status endpoints need a flag Set `ENABLE_PUBLIC_API=true` if you want to call `/api/public/summary`, `/api/public/health`, version, or update-check endpoints. Without it, those public status checks are disabled. source

Fetched 54 days ago - each note links to its source

Alternatives (2)

  • WUD (What's Up Docker?) - Self-hosted service to monitor Docker container updates with a modern web UI and trigger notifications or automated actions.
  • WatchTower - Watchtower is a Docker container updater that automatically applies new images to running applications.

Checked 40 days ago - source: AlternativeTo

Common questions

Do I need to run Tugtainer-Agent separately from the Tugtainer backend?

Yes. The backend and agent are separate pieces, so run them in separate terminal windows, such as python -m backend.dev and python -m agent.dev. If one isn't running, the app won't be able to manage containers.

What security settings should I configure in the agent .env?

Copy .env.example to .env and set values like AGENT_SECRET. Keep ALLOW_EXEC=false unless you truly want the agent to run shell commands inside containers. If ALLOW_EXEC is enabled, a mistaken or bad request can run arbitrary commands in containers.

Is there a known Tugtainer-Agent connection failure with HTTP 424?

Yes. A GitHub issue reports a failed connection to tugtainer-agent with HTTP 424 when using two agents after a first install. The issue notes that agents were a recent change at the time.

Can Tugtainer use agents on multiple Docker hosts?

Yes. Tugtainer is described as supporting multi-host agents, rollback, and alerts.

Does Tugtainer-Agent provide remote access to Docker hosts?

Yes. The agent part of Tugtainer provides secure remote access to Docker hosts.

Answers sourced from github.com, github.com, github.com, hub.docker.com, www.bitdoze.com

Community

Collected 48 days ago - public community threads