Traefik Rolling Update

A Unraid plugin that provides zero-downtime updates for Docker containers running behind Traefik.

  • Infrastructure
  • Plugins
  • Tools & Utilities
A Unraid plugin that provides zero-downtime updates for Docker containers running behind Traefik. Tick a container in Settings and the Docker page's Update / Update All start the new version next to the old one, let Traefik switch over once it is healthy, then remove the old one. If the new version never becomes healthy it is removed and the running instance is untouched. Nothing else to configure: missing Traefik service/port labels and healthchecks are added automatically, the template is never modified; an optional per-container HTTP healthcheck (path, expected code, text, timing) is available in Settings. Containers you do not tick keep Unraid's stock Update. Requires Unraid 7.3.0+ and Traefik with its Docker provider; a ticked container must tolerate two instances running for a few seconds and must not publish a host port.

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.

47/100 Fair

Maintained
69last commit 67 days ago
Popular
61 GitHub stars
Easy to install
251 install platform, install notes
Light to run
85512 MB minimum RAM

Availability: platform listings confirmed today

GitHub stars
1
Open issues
0
Last commit
2026-09-15
Latest release
2026.09.15
License
GPL-2.0
Activity
stale

Checked yesterday - source: GitHub (Greite/unraid-traefik-rolling-update)

Resources & Compatibility

Minimum requirements: 512 MB RAM.

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

First-install notes

  • Start Traefik with these Docker settings Create a small traefik.yml, then start the container with ports 80 (your websites) and 8080 (dashboard/debug) mapped, and mount the Docker socket (Docker's control file for seeing containers). Without that socket, Traefik can't find your other Docker apps. source
  • Put main settings in a config file first Before starting Traefik, put its entry points (the ports it listens on), Docker provider, and dashboard settings in a YAML or TOML config file. If these are missing or wrong, Traefik may start but not send requests to your apps the way you expect. source
  • Delete old v2 settings that stop v3 If you reused an older Traefik v2 file, remove any pilot token and InfluxDB v1 metrics settings. They are unsupported in v3 and will keep Traefik from starting. source
  • Enable per container in Settings Install the plugin on Unraid, then open Settings and tick each container you want to update zero-downtime. The plugin adds the required Traefik service/port labels and a healthcheck automatically and never modifies the template, so no per-container config is needed. Ticked containers must tolerate two instances running for a few seconds and must not publish a host port. source
  • Prerequisites and container requirements Requires Unraid 7.3.0+ and Traefik with its Docker provider; enabled containers must tolerate two instances briefly and must not publish a host port. source

Fetched 44 days ago - each note links to its source

Alternatives (10)

  • BunkerWeb - BunkerWeb is a self-hosted, open-source web application firewall and NGINX-based web server that protects services with secure-by-default s…
  • Caddy - Caddy is an extensible web server and reverse proxy that serves Transport Layer Security (TLS) by default, making it simple to secure and r…
  • Envoy Gateway - Envoy Gateway is an open-source project that manages Envoy Proxy as a standalone or Kubernetes-based application gateway.
  • Fossorial Pangolin - Open-source identity-based remote access platform using WireGuard, offering unified management, tunneled connections, granular access contr…
  • Haproxy - HAProxy is a TCP proxy and a HTTP reverse proxy.
  • Nginx Proxy Manager - Nginx Proxy Manager is a self-hosted reverse proxy and web server that lets you expose home or small-office applications to the internet wi…
  • nginx - Nginx is an HTTP web server, reverse proxy, content cache, load balancer, TCP/UDP proxy, and mail proxy server.
  • npmplus - NPMplus is an improved fork of Nginx Proxy Manager that provides a web interface for managing reverse proxy rules, SSL certificates, and ap…
  • traefik - Traefik is a modern HTTP reverse proxy and load balancer that integrates with Docker, Kubernetes, and other container orchestrators to conf…
  • tsdproxy - TSDProxy is a Tailscale proxy for Docker containers that automatically creates Tailscale machines for labeled containers, providing automat…

Checked 40 days ago - source: AlternativeTo

Common questions

How do I enable zero-downtime updates for a specific container?

Open Settings, Utilities, Traefik Rolling Update after installing the plugin, set Zero-downtime update to Yes for the container, Apply, and reload the Docker page.

Do I need to add Traefik labels or a healthcheck myself?

No, the plugin automatically adds missing Traefik service and server.port labels and a missing healthcheck to the new instance. It never modifies the template.

What happens if the updated instance never becomes healthy?

The plugin removes the failed new instance, restores the image tag, and leaves the running instance untouched. It also keeps the update-ready badge and sends a notification with the reason and last healthcheck output.

What should I do if my container publishes a host port?

Remove the host port from the template because Traefik does not need one. Put the public URL in the WebUI field instead.

What happens to containers I do not enable?

Containers you do not tick keep Unraid's stock Update behavior. Uninstalling the plugin restores the stock behavior entirely.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads