Skip to content

Getting Started with Traefik Enterprise Edition's Installation

We recommend using traefikeectl to install TraefikEE on Kubernetes or Docker Swarm Mode.

But for experts who need to fine tune every step of the installation, we provide advanced installation guides (TraefikEE on Kubernetes Using YAML files).

Install traefikeectl

First, download traefikeectl, a tool that will help you install and operate your cluster, using one of the following links:

Check the integrity of the downloaded file

Use the sha256 checksums of the binaries:

# Compare this value to the one found in SHA256SUMS.txt
sha256sum ./traefikeectl_linux-amd64
# Compare this value to the one found in SHA256SUMS.txt
shasum -a256 ./traefikeectl_darwin-amd64
# Compare this value to the one found in SHA256SUMS.txt
Get-FileHash traefikeectl_windows-amd64.exe -Algorithm SHA256

Copy the traefikeectl binary to your PATH or add its location to your environment ($PATH or %PATH% depending on your OS) and make sure it's executable:

# Example with /usr/local/bin
# These command may need sudo rights
cp ./traefikeectl_linux-amd64 /usr/local/bin/traefikeectl
chmod a+x /usr/local/bin/traefikeectl

# Should print "/usr/local/bin/traefikeectl"
command -v traefikeectl
# Example with C:\Program Files
Copy-Item "traefikeectl_windows-amd64.exe" -Destination "C:\Program Files\traefikeectl.exe"

# Should print "C:\Program Files\traefikeectl.exe"
where traefikeectl

You can now test your installation by executing traefikeectl:

Usage: traefikeectl [flags] <command> [<arguments>]

Use "traefikeectl <command> --help" for help on any command.

Use traefikeectl to Install TraefikEE on Your Cluster

To setup your cluster, traefikeectl will need the following information:

  • Your license key
  • The cluster name

Once you've gathered the required information, refer to one of the following guide depending on your infrastructure solution:

Verify Your Installation

To certify that your TraefikEE installation is ready, you can query the nodes' state with the following command:

traefikeectl list-nodes

This command prints the list of all deployed nodes from both the Control Plane and the Data Plane.

Example output for a TraefikEE cluster with 3 nodes in the control plane and 2 nodes in the data plane:

Name                                            Role
----                                            ----
bootstrap-traefikee-bootstrap-647965c6b5-xfktd  CONTROL NODE (Current Leader)
traefikee-control-node-1                        CONTROL NODE
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.

Next Steps

Now that you have installed a TraefikEE cluster, you can: