Skip to content

Added CertificateTimeout ACME configuration option.#12278

Merged
traefiker merged 1 commit intotraefik:masterfrom
RIT-ITS:master
Jan 12, 2026
Merged

Added CertificateTimeout ACME configuration option.#12278
traefiker merged 1 commit intotraefik:masterfrom
RIT-ITS:master

Conversation

@ceko
Copy link
Contributor

@ceko ceko commented Nov 14, 2025

What does this PR do?

This feature allows each configured certificateResolver to 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.

certificatesResolvers:
  prod:
    acme:
      email: certs@acme.com
      certificateTimeout: "2m"

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

  • Added/updated tests
  • Added/updated documentation

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.

Copy link
Member

@mmatur mmatur left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for your contribution @ceko

Could you also add documentation?

@ceko
Copy link
Contributor Author

ceko commented Jan 8, 2026

I changed FinalizationTimeout to CertificateTimeout to better align with the LEGO options. I also added documentation. Let me know if you'd like anything else to support this change.

@ceko ceko changed the title Added FinalizationTimeout ACME configuration option. Added CertificateTimeout ACME configuration option. Jan 8, 2026
@ceko ceko requested a review from mmatur January 8, 2026 14:46
Copy link
Member

@mmatur mmatur left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Thanks @ceko

@mmatur mmatur added this to the next milestone Jan 8, 2026
Copy link
Member

@rtribotte rtribotte left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks

@traefiker traefiker merged commit 93f7cb1 into traefik:master Jan 12, 2026
54 of 65 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/acme kind/enhancement a new or improved feature. size/S

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

Comments