Submitting Issues

Issues are perfect for requesting a feature/enhancement or reporting a suspected bug. We use the GitHub issue tracker to keep track of issues in Traefik.

The process of sorting and checking the issues is a daunting task, and requires a lot of work (more than an hour a day … just for sorting). To help us (and other community members) quickly and effortlessly understand what you need, be sure to follow the guidelines below.

Getting Help Vs Reporting an Issue

The issue tracker is not a general support forum, but a place to report bugs and asks for new features.

For end-user related support questions, try using the

The title must be short and descriptive. (~60 characters)

Examples:

• Bug: Duplicate requests in access logs

Traefik is an open source project and aims to be the best edge router possible.

Remember when asking for new features that these must be useful to the majority (and not only useful in edge case scenarios, or hack-like setups). Follow the issue template as much as possible.

Do your best to explain what you’re looking for, and why it would improve Traefik for everyone. Be detailed and share the use-case(s) to allow us to see the value of your feature request as quickly as possible.

If you are interested in creating a PR for your feature request, let us know in the issue, so we can work with you. It can take a lot of work to make sure a PR can integrate with our existing code and planning with the team ahead of time can make sure that your PR can be accepted and merged quickly.

Follow the issue template as much as possible.

Explain the conditions in which you encountered the issue; what is your context? Share any logs you may have, and make sure to share the steps it takes to reproduce your issue or bug.

Remain as clear and concise as possible.

Take time to polish the format of your message, so we’ll enjoy reading it and working on it. Help your readers focus on what matters and help them understand the structure of your message (see the ).