Skip to main content

Installation

Install and configure Traefik Hub API Gateway.

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:

  • Kubectl
  • Helm v3
  • Checked the documentation about networking details to make sure that the Traefik Hub API Gateway can communicate with Traefik Hub to validate the token.

To install Traefik Hub API Gateway, copy and paste the following instructions. This will install Traefik Hub API Gateway.

Install Traefik Hub API Gateway
# Add the Helm repository
helm repo add traefik https://traefik.github.io/charts
helm repo update

# Install Traefik Hub API Gateway
kubectl create namespace traefik-hub
kubectl create secret generic hub-agent-token --namespace traefik-hub --from-literal=token=YOUR-TRAEFIK-HUB-TOKEN
helm upgrade --install --namespace traefik-hub traefik-hub traefik/traefik-hub
  • YOUR-TRAEFIK-HUB-TOKEN: Your token provided by Traefik Labs
Custom Configuration

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

Did You Know

That the Traefik Hub Helm Chart is open source and that contributors are welcome?

Migrating from Traefik Proxy​

To migrate from Traefik Proxy, install the Traefik Hub API Gateway as described above and delete the Traefik Proxy release.

Install Traefik Hub API Gateway
# Add the Helm repository
helm repo add traefik https://traefik.github.io/charts
helm repo update

# Install Traefik Hub API Gateway
kubectl create namespace traefik-hub
kubectl create secret generic hub-agent-token --namespace traefik-hub --from-literal=token=YOUR-TRAEFIK-HUB-TOKEN
helm upgrade --install --namespace traefik-hub traefik-hub traefik/traefik-hub

# Delete Traefik Proxy 
helm delete traefik
  • YOUR-TRAEFIK-HUB-TOKEN: Your token provided by Traefik Labs
Custom Configuration

If the Traefik Proxy uses a custom configuration, please refer to the Traefik Hub API Gateway custom configuration documentation to check if the values are supported by Traefik Hub API Gateway. Then report them to the Traefik hub installation.

Related Content​