Troubleshoot issues

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

Certificates¶

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.

IdP¶

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¶

Agents¶

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

Examples

Dashboard

API overview page

GitOps¶

Argo CD¶

OutOfSync issues¶

When using Argo CD, one must set the application.instanceLabelKey value in the argocd-cm to argocd.argoproj.io/instance instead of app.kubernetes.io/instance.

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.