Unraid Traefik Rolling Update
Projet open source de Gauthier Painteaux
Sur Unraid, updater un container signifie l’arrêter, le supprimer puis le recréer : le site est down pendant toute l’opération. Derrière Traefik, ce n’est pas nécessaire. Ce plugin démarre la nouvelle version à côté de l’ancienne et ne switche qu’une fois qu’elle est prête.
- PHP
- Unraid
- Traefik
- Docker
- Version
- 2026.09.15
- Étoiles
- 1
- Licence
- GPL-2.0
- Mis à jour le
- requêtes perdues sur ~500 pendant le switch, contre l’update natif d’Unraid
- 1–2 vs ~50
- label ou healthcheck à écrire
- 0
Comment fonctionne Unraid Traefik Rolling Update
- 1
Pull
La nouvelle image est téléchargée.
- 2
Démarrage
Une 2ᵉ instance démarre à côté.
- 3
Health gate
Traefik attend qu’elle soit healthy.
- 4
Switch
L’ancienne instance est arrêtée.
- 5
Cleanup
Ancien container et image supprimés.
Points forts d’Unraid Traefik Rolling Update
Rollback automatique
Si la nouvelle version ne devient jamais healthy, elle est supprimée et l’ancienne continue de tourner, avec une notification qui explique pourquoi.
Aucune configuration
Les labels Traefik et le healthcheck manquants sont ajoutés automatiquement à la nouvelle instance, le template n’est jamais modifié.
Healthcheck sur mesure
Par container : chemin, port, code HTTP et texte attendus, intervalle et délais, à la manière de Coolify.
Natif partout ailleurs
Les containers non cochés gardent l’update natif d’Unraid, et désinstaller le plugin rétablit le comportement d’origine.
En images
Choix techniques d’Unraid Traefik Rolling Update
- PHP
- Le plugin se branche sur les boutons Update de la page Docker d’Unraid et ajoute sa page de réglages.
- Healthchecks Docker
- Traefik ignore les containers qui ne sont pas healthy : c’est ce qui sert de health gate avant le switch.
- Labels Traefik
- Le service et le port implicites de l’ancienne instance sont recopiés, selon les règles de Traefik.
- Self-tests
- La logique de décision est testée en local, sans Docker ni serveur Unraid.
Installer Unraid Traefik Rolling Update
- 1
Dans Unraid, ouvrir Plugins › Install Plugin et coller l’adresse du plugin.
- 2
Dans Settings › Utilities › Traefik Rolling Update, passer les containers voulus en zero-downtime.
- 3
Recharger la page Docker : Update et Update All passent désormais par le rolling update.
https://raw.githubusercontent.com/Greite/unraid-traefik-rolling-update/main/traefik.rolling.update.plg