Added CertificateTimeout ACME configuration option.#12278
Merged
traefiker merged 1 commit intotraefik:masterfrom Jan 12, 2026
Merged
Added CertificateTimeout ACME configuration option.#12278traefiker merged 1 commit intotraefik:masterfrom
traefiker merged 1 commit intotraefik:masterfrom
Conversation
Contributor
Author
|
I changed |
mmatur
approved these changes
Jan 8, 2026
rtribotte
reviewed
Jan 12, 2026
docs/content/reference/install-configuration/tls/certificate-resolvers/acme.md
Show resolved
Hide resolved
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this PR do?
This feature allows each configured
certificateResolverto specify a finalization (sometimes referred to as certificate) timeout. The configured value is passed to the Lego ACME client library and is used to determine how long the the client waits for an order to transition from ready -> valid.Motivation
The default Lego ACME client timeout is 30 seconds. This is too short for some certificate authorities and can cause intermittent timeouts. Traefik already passes through several configuration values to the Lego ACME client so it seemed like an easy fix with code patterns already available.
More
Additional Notes
This type of problem is present in most ACME clients that develop towards LetsEncrypt as a baseline. I created this change both to allow our Traefik instances to successfully request certificates and to contribute back a longstanding community request.
I did not include tests because it's inherently difficult to write a timeout test. It usually slows down the suite and tests for config passing seem rote instead of useful. I am willing to write tests if necessary.
I am willing to update documentation if this request gains traction. I'd like to agree on a configuration key name first.