Traefik Enterprise Edition Installation Quick Start¶
traefikeectl Command-Line Tool¶
traefikeectl Command-Line tool (reads: "TraefikEE-Cuddle")
helps with managing and configuring your TraefikEE installations.
traefikeectl, please follow the instructions on the page
traefikeectl Command-Line Tool".
Install TraefikEE with
Install your TraefikEE cluster on Kubernetes or Docker Swarm with the following "one line" command:
traefikeectl install \ --licensekey="XXXXXXXXX" \ --dashboard \ --kubernetes # Take note of the dashboard's generated credentials
traefikeectl install \ --swarm --licensekey="XXXXXXXXX" \ --dashboard \
If you want to customize the default settings, please check the following guides:
- Customizing the One-Line Installation of Traefik Enterprise Edition on Kubernetes
- Installing Traefik Enterprise Edition on Docker Swarm
If you plan to install TraefikEE On-Premise (on VMs, bare-metal machines or unsupported platforms),
you will not be able to use the previous "one line" command for installation. However, you will be able to perform other operations by using the
traefikeectl connect command.
In that case, please follow the instructions on the page Installing Traefik Enterprise Edition On-Premise.
Step by step installation
Name Role ---- ---- traefikee-control-node-1 CONTROL NODE (Current Leader) data-node-traefikee-data-node-68d856488c-5vx5n DATA NODE data-node-traefikee-data-node-68d856488c-stgns DATA NODE traefikee-control-node-2 CONTROL NODE traefikee-control-node-0 CONTROL NODE
Congratulations! Your TraefikEE cluster is ready.
Access the Dashboard¶
You can now access the TraefikEE Dashboard by using your web browser:
- On Kubernetes: at the URL
<public-hostname>is the public hostname of the LoadBalancer Service for TraefikEE. Use the credentials that can be found in the output of the
Retrieve public hostname on Kubernetes
# Value of the field "External IP" kubectl get services --namespace=traefikee traefikee-data-svc
- On Docker Swarm: at the URL
<swarm-node-ip>can be the IP address of any node of your Swarm.
Setup the Routing Configuration¶
TraefikEE requires a "Routing Configuration" (also known as Static Traefik Configuration) to know how and where to route requests.
When you use
traefikeectl install, a default static configuration is deployed during the installation process.
By default, you have nothing to do: you can go straight to the next section, as your platform is already watched by TraefikEE for Dynamic Traefik Configuration
Deploy a Traefik Configuration
To specify a static configuration, no need to restart TraefikEE:
traefikeectl deploy command instead.
You can either use command-line options:
traefikeectl deploy --kubernetes \ --entryPoints='Name:internal Address::8888' \ --defaultentrypoints=internal
or you can use a TOML file:
traefikeectl deploy --configFile=./traefik.toml
[kubernetes] defaultEntryPoints = ["internal"] [entryPoints] [entryPoints.internal] address = ":8080"
Deploy your Application¶
TraefikEE is ready to route the incoming requests to your backend applications.
Try it by deploying an example backend application named
curl -L http://localhost:8000/includes/kubernetes-whoami.yaml \ | kubectl apply -f -
curl -L http://localhost:8000/includes/docker-whoami.yaml \ | docker stack deploy -c - ""
The "whoami" application is now available at
Now that you have installed a TraefikEE cluster, you can: