Skip to content

Upgrading the Traefik Hub Agent

This document demonstrates how to upgrade an existing Traefik Hub Agent installation in different environments.


Refresh the helm chart to get the newest version and then re-run the installation command:

helm repo update
helm upgrade hub-agent traefik/hub-agent \
  --reuse-values --namespace hub-agent


Stop the Hub Agent container.

Update the version and start the container again:

# Launch the Hub Agent for Traefik
docker run -d  --volume /var/run/docker.sock:/var/run/docker.sock \
--restart="on-failure" \
--network=traefik-hub \
--pull=always \
--name=hub-agent run \
--auth-server.advertise-url=http://hub-agent \
--hub.token=XXXXX \ \
  • vX.X.X is the latest version of the container
  • hub.token=XXXXX is your Traefik Hub token

Docker Compose


Stop docker-compose:

docker-compose down

Update the tag of the container to the latest version:

# Start the agent with the latest version
  • vX.X.X is the latest version of the container

Start docker-compose again:

docker-compose-hub-agent.yaml up -d


Stop docker-compose, pull the latest container image and start docker-compose again:

docker-compose down
docker-compose pull
docker-compose-hub-agent.yaml up -d