Skip to content

Troubleshoot issues

How to determine, diagnose, and fix issues that you might encounter when you use Traefik Hub.


Troubleshoot certificate related errors.

The certificate is not trusted because it is self-signed

It is possible that you see this error during the initialization of Let's Encrypt certificates. Once the initialization succeeded and the service uses the new certificate, this error goes away.

If you experience that the message is persistent, please restart your Traefik Hub agent and check your logs for errors.

Not Trusted Certificates

Generating a Let's Encrypt certificate for new domains requires more time than exposing the service. It might end in a window where the service is available with the wrong certificate.

During this time, Traefik Hub serves a self-signed certificate.


Users are not shown in the dashboard

The user overview dashboard will not list automatically all users after synchronization. Users will be only listed after a first successful login into Traefik Hub.

Connectivity errors


When a Traefik Hub agent is facing connectivity issues, the UI will display a warning icon with the tooltip Agent is offline.



Agent health status in the dashboard

API overview page

Agent health status on the API overview page


Argo CD

OutOfSync issues

When using Argo CD, one must set the application.instanceLabelKey value in the argocd-cm to instead of

This helps avoid OutOfSync issues with Traefik Hub resources, as Traefik Hub also use the same label with the Hub Helm install.

See the Argo CD FAQ for more information.