Skip to content

acme.sh

v3.1.4 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

Published 10d Secrets & Credentials
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

acme acme-challenge acme-protocol acme-v2 ash shell
+10 more
buypass certbot lets-encrypt posix posix-sh tls ssl-certificate ssl-certificates tls-certificate zerossl

Affected surfaces

auth

Summary

AI summary

dns_hetzner.sh was removed.

Changes in this release

Feature Medium

Support ACME Renewal Information (ARI) enabled by default.

Support ACME Renewal Information (ARI) enabled by default.

Source: llm_adapter@2026-07-17

Confidence: high

Feature Medium

Support dns-persist-01 challenge with --dns-persist-days option.

Support dns-persist-01 challenge with --dns-persist-days option.

Source: llm_adapter@2026-07-17

Confidence: high

Feature Medium

Negative --days schedules renewal relative to cert expiration date.

Negative --days schedules renewal relative to cert expiration date.

Source: llm_adapter@2026-07-17

Confidence: high

Feature Medium

Support ACME account key rollover.

Support ACME account key rollover.

Source: llm_adapter@2026-07-17

Confidence: high

Feature Medium

Support multiple account emails; --update-account persists new email.

Support multiple account emails; --update-account persists new email.

Source: llm_adapter@2026-07-17

Confidence: high

Feature Medium

Add new DNS providers: Level27, CDMON, Poweradmin, IP-Projects, EuroDNS, Firestorm, creoline, LaoDC, WEDOS, muumuu, Volcano Engine, Glesys, Aruba Business, Calrissia, Hostinger.

Add new DNS providers: Level27, CDMON, Poweradmin, IP-Projects, EuroDNS, Firestorm, creoline, LaoDC, WEDOS, muumuu, Volcano Engine, Glesys, Aruba Business, Calrissia, Hostinger.

Source: llm_adapter@2026-07-17

Confidence: high

Feature Medium

Add new deploy hooks: FortiGate, Baidu Cloud CDN, Windows RDP.

Add new deploy hooks: FortiGate, Baidu Cloud CDN, Windows RDP.

Source: llm_adapter@2026-07-17

Confidence: high

Feature Medium

Add customscript notify hook.

Add customscript notify hook.

Source: llm_adapter@2026-07-17

Confidence: high

Feature Low

Add bash completion, installed via --install.

Add bash completion, installed via --install.

Source: llm_adapter@2026-07-17

Confidence: high

Feature Low

Renewals follow CA-suggested renewal window when ARI is used.

Renewals follow CA-suggested renewal window when ARI is used.

Source: granite4.1:30b@2026-07-17-audit

Confidence: low

Feature Low

Cron job runs every 6 hours to react to ARI windows.

Cron job runs every 6 hours to react to ARI windows.

Source: granite4.1:30b@2026-07-17-audit

Confidence: low

Feature Low

Negative --days can be combined with --valid-to for renewal margin.

Negative --days can be combined with --valid-to for renewal margin.

Source: granite4.1:30b@2026-07-17-audit

Confidence: low

Feature Low

Docker images are now also published to ghcr.io registry.

Docker images are now also published to ghcr.io registry.

Source: granite4.1:30b@2026-07-17-audit

Confidence: low

Deprecation Medium

Remove dns_hetzner.sh script (issue #6990).

Remove dns_hetzner.sh script (issue #6990).

Source: granite4.1:30b@2026-07-17-audit

Confidence: low

Bugfix Medium

Retry failed install/deploy steps on the next renewal.

Retry failed install/deploy steps on the next renewal.

Source: llm_adapter@2026-07-17

Confidence: low

Full changelog
  1. Support ACME Renewal Information (ARI, RFC 9773), enabled by default. Renewals now follow the renewal window suggested by the CA. Set NO_ARI=1 to disable. The installed cron job now runs every 6 hours to react to ARI renewal windows in time.
  2. Support the dns-persist-01 challenge, with --dns-persist-days.
  3. A negative --days schedules renewal relative to the cert expiration date, and can be combined with --valid-to to set a renewal margin.
  4. Support ACME account key rollover.
  5. Support multiple account emails. --update-account now persists the new email.
  6. Retry failed install/deploy steps on the next renewal.
  7. Add bash completion, installed via --install.
  8. New DNS providers: Level27, CDMON, Poweradmin, IP-Projects, EuroDNS, Firestorm, creoline, LaoDC, WEDOS, muumuu, Volcano Engine, Glesys, Aruba Business, Calrissia, Hostinger. New deploy hooks: FortiGate, Baidu Cloud CDN, Windows RDP. New notify hook: customscript.
  9. dns_hetzner.sh was removed (#6990).
  10. Docker images are now also published to ghcr.io.
  11. A lot of bug fixes.

Breaking Changes

  • Removed dns_hetzner.sh plugin

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track acme.sh

Get notified when new releases ship.

Sign up free

About acme.sh

All releases →

Beta — feedback welcome: [email protected]