# 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. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1026/tugtainer-agent

## Description

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 9 platforms: Unraid.

## Health score

74/100 (Good), based on 3 of 4 factors.
- Maintained: 100 (last commit 19 days ago)
- Popular: 64 (1,542 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/quenary/tugtainer-agent
- Unraid: https://ca.unraid.net/apps/tugtainer-agent-1qir2ph1jbm841?q=Tugtainer-Agent
- GitHub: https://github.com/Quenary/tugtainer

## 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.

## Alternatives

- 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/1026/tugtainer-agent), the self-hosted and open-source app directory.
