Migration Guide: From v1 to v2

How to Migrate from Traefik v1 to Traefik v2.

The version 2 of Traefik introduced a number of breaking changes, which require one to update their configuration when they migrate from v1 to v2.

For more information about the changes in Traefik v2, please refer to the v2 documentation.

Migration Helper

We created a tool to help during the migration: traefik-migration-tool

This tool allows to:

• convert Ingress to Traefik IngressRoute resources.
• convert acme.json file from v1 to v2 format.
• migrate the static configuration contained in the file traefik.toml to a Traefik v2 file.