Skip to main content


Install and configure Traefik Hub.

Before You Begin

Before you begin the installation process, it is recommended that you have a basic understanding of Kubernetes.
You should have access to a working Kubernetes cluster, either on a cloud provider or on your own infrastructure.

Please make sure that you have the following:

To install Traefik Hub, go to the Traefik Hub Dashboard.

When working on a new setup, the welcome page will invite you to Create my first Traefik Hub agent as shown below.

Choose install

Choose Traefik Hub as Ingress Controller (this is the default installation method) and follow the steps in the UI.

Ingress Controller mode

Copy and paste the instructions provided in step 2 and run them on your cluster. This will install Traefik Hub.

We recommend you save the agent token provided in step 3 for future reference. If you lose this token, you won't be able to recover it and will need to go through a new installation process.

As the last step (4) give the agent a name or use the random created one by Traefik Hub.

Select Configuration Done. Traefik Hub will then detect your newly installed agent.

Custom Configuration

For adjusting the default configuration, please refer to the custom configuration documentation.

Install Multiple Agents on Multiple Clusters


It is not possible to install multiple Traefik Hub agents on a single cluster.

Traefik Hub allows you to configure multiple clusters that you will manage from the same dashboard.
When installing your second agent, you will find the option to proceed with the installation in the cluster agents page.

Create second cluster agent.