chore(deps): update docker.io/thecodingmachine/gotenberg docker tag to v8.25.1

[renovate]

This PR contains the following updates:

Package	Update	Change
docker.io/thecodingmachine/gotenberg	minor	8.11.1 → 8.25.1

---

Release Notes

gotenberg/gotenberg (docker.io/thecodingmachine/gotenberg)

v8.25.1: 8.25.1

Compare Source

Bug Fixes

Chromium

• The Chromium module health check was consuming an inappropriate amount of resources. This fix reduces CPU wasted cycles by 98% and ensures memory usage remains somewhat flat over time. Thanks to @​ldy985 for the investigation, solution, and testing. More details are available here.
• Added net::ERR_HTTP2_PROTOCOL_ERROR to the list of events for the failOnResourceLoadingFailed feature. Thanks to @​aW3st for the fix!

Chore

Updated Go dependencies.

v8.25.0: 8.25.0

Compare Source

New Features

Encrypt

This release adds the password protection feature to Chromium, LibreOffice, and PDF Engines modules.

Thanks @​thoven87 for the work!

Embed Files

This feature enables the creation of PDFs compatible with standards like ZUGFeRD / Factur-X, which require embedding XML invoices and other files within the PDF.

Available on the Chromium, LibreOffice, and PDF Engines modules.

Thanks a lot @​Jean-Beru for this feature!

Bug Fixes

• Chromium: Gotenberg now correctly accepts case-insensitive values for the cookies' sameSite attribute.
• Chromium: the flag --chromium-incognito is now deprecated and we ignore its value.

Chore

• Updated Chromium to version 142.0.7444.162.
• Updated pdfcpu to version 0.11.1.
• Updated Go dependencies.
• Bumped Go to version 1.25.4.

v8.24.0: 8.24.0

Compare Source

New Features

New Architecture - ppc64le

We now support the linux/ppc64le architecture. Thanks @​roy20021 for the help!

LibreOffice Hyphenation Support

Hyphenation is now supported in LibreOffice, improving text formatting and readability. Thanks @​omni-htg for the work!

Chore

• Updated Chromium to version 141.0.7390.
• Updated Go dependencies.
• Updated Noto Color Emoji font to v2.051.

v8.23.2: 8.23.2

Compare Source

Bug Fix

Build

This release removes the UPX compression stage, which was intended to reduce binary size but is causing startup panics in some environments - thanks @​lobeck for the heads up! See #​1333 for more details.

Chore

Updated Go dependencies.

v8.23.1: 8.23.1

Compare Source

Bug Fix

Chromium

The new version of Chromium fixes #​1239 - better compression for images, resulting in smaller PDF.

Thanks @​VeiaG, @​CmCarti, and @​zocario for the help!

Chore

• Updated Chromium to version 140.0.7339.127-1.
• Updated LibreOffice to version 25.8.1-1.
• Updated Go dependencies.

v8.23.0: 8.23.0

Compare Source

New Feature

MathJaX Support

This release adds MatchJaX support for markdown conversion with the Chromium module. Thanks @​zekizz for the heads up!

Bug Fixes

AWS Lambda (Beta)

A few changes based on feedback from @​brettjenkins:

• AWS_LWA_INVOKE_MODE uses now the buffered value.
• No more auto start from Chromium and LibreOffice.

[!NOTE]
There is an ongoing discussion about improving this variant.
If you have feedback, please feel free to share it in the thread!

Chromium

Hypen data are now located in /opt/gotenberg. Thanks @​PureKrome, @​raraworks, and @​SanderBlom!

Chore

Updated Go dependencies.

v8.22.0: 8.22.0

Compare Source

New Features

Webhook Sync Mode

New flag --webhook-enable-sync-mode (or environment variable WEBHOOK_ENABLE_SYNC_MODE) to enable synchronous mode for webhooks.

This is especially useful in serverless environments. Thanks @​ynarwal!

Cloud Run

This image is now preconfigured for Cloud Run with the following:

• Uses the PORT environment variable provided by Cloud Run.
• Logs in a format compatible with Cloud Run.
• Auto-starts Chromium and LibreOffice for faster readiness.
• Uses synchronous webhook mode, since Cloud Run may stop the container if there’s no HTTP activity.

AWS Lambda

We now provide a dedicated Docker image tag, available on both linux/amd64 and linux/arm64 architectures:

gotenberg/gotenberg:8-aws-lambda

This image is preconfigured for AWS Lambda:

• Uses the AWS_LWA_PORT environment variable provided by AWS Lambda.
• Auto-starts Chromium and LibreOffice for faster readiness.
• Uses synchronous webhook mode, since AWS Lambda may stop the container if there’s no HTTP activity.

Thanks @​ynarwal and @​sefij!

Bug Fix

Chromium

• Hyphens are now working all the time. Thanks @​BernhardBaumrock for the sponsorship!

Chore

• Updated base image to Debian 13 (trixie).
• Updated Chromium to version 139.0.7258.127-1 (all platforms). Note: the linux/amd64 variant now also uses Chromium instead of Google Chrome stable.
• Updated pdfcpu to version 0.11.0.
• Updated noto-color-emoji to version 2.048.
• Updated Go to version 1.25.
• Updated Go dependencies.

v8.21.1: 8.21.1

Compare Source

This release fixes fonts issues.

See #​1218 and #​1230 for more details - thanks @​DoPri and @​scott-the-programmer for the help!

Chore

• Updated Chromium to version 137.0.7151.103/68 (all platforms).
• Updated Go dependencies.

v8.21.0: 8.21.0

Compare Source

👶 Newborn at home, but weirdly found some time for a new release!

New Features

Docker

• Supports arbitrary user IDs (OpenShift) – thanks @​leonidas-o for the help!
• Docker image size reduced by 5–8%, depending on the architecture.
• Most Debian dependencies now include version pins, making it easier to track updates – thanks @​ChocoChipset!

Chromium

• When splitting a PDF, you can now define filenames for the parts using the GOTENBERG_OUTPUT_FILENAME header – thanks @​zach-goldberg for the idea!
• New form field generateTaggedPdf, which may yield better results if you prioritize accessibility over strict (and sometimes hacky) PDF/UA compliance.

Bug Fixes

Chromium

• Added --no-zygote and --disable-dev-shm-usage flags – see issue #​1177.
• Fixed missing page cleanup after conversions – thanks @​RandalTeng!

Webhook

• Improved error message when using the /forms/pdfengines/metadata/read route.

Chore

• Updated Chromium to version 136.0.7103.113 (all platforms).
• Updated Go dependencies.

v8.20.1: 8.20.1

Compare Source

Bug Fix

The previous release revealed a bug that could randomly result in 500 Internal Server Error responses when using the split feature. This has now been fixed.

v8.20.0: 8.20.0

Compare Source

New Features

• You can now disable the building of debug data using the new --gotenberg-build-debug-data flag (default: true)
  or the GOTENBERG_BUILD_DEBUG_DATA environment variable. This can significantly improve startup time in environments like Google Cloud Run.
  Thanks @​ChocoChipset for the contribution!

• You can now override the Content-Disposition header when using the webhook feature.
  Thanks @​stephentgrammer!

Bug Fix

• Fixed an issue where the merge order was sometimes incorrect.
  Thanks @​JhnBer!

Chore

• Updated Chromium to version 135.0.7049.84 (all platforms).
• Updated Go dependencies.

v8.19.1: 8.19.1

Compare Source

Bug Fixes

This release includes two bug fixes for the Chromium module:

1. A minor issue in a dependency was causing generated PDFs to be tagged by default. That’s no longer the case.
   Thanks to @​dani for the heads-up and @​kenshaw for the resolution!

2. The printBackground form field now works as expected.
   Thanks @​Welteam for reporting the issue!

Chore

• Updates Chromium to version 135.0.7049.52 (amd64 only).
• Updates Go dependencies.

v8.19.0: 8.19.0

Compare Source

New Feature

Improved log field mapping for Cloud Run with the new --log-enable-gpc-fields (or LOG_ENABLE_GCP_FIELDS) flag.
The previously introduced --log-enable-gcp-severity flag has been deprecated in favor of this new option.

Thanks @​ChocoChipset for the help!

Chore

• Updates Go Dependencies.
• Updates LibreOffice to version 25.2.1 (all platform).

v8.18.0: 8.18.0

Compare Source

New Features

Cloud Run

New flag --log-enable-gcp-severity (or environment variable LOG_ENABLE_GCP_SEVERITY) to map the log level with its corresponding severity in Cloud Run.

Thanks @​ChocoChipset for the suggestion!

LibreOffice Optional Indexes Update

New form field updateIndexes (default true) for the route /forms/libreoffice/convert. Set its value to false if your PDF is missing links present in the original document.

Thanks @​RinseV for the heads-up!

Chore

• Updates Chromium to version 134.0.6998.88.
• Updates LibreOffice to version 25.2.1 for the amd64 platform.
• Updates Go Dependencies.

v8.17.3: 8.17.3

Compare Source

Bug Fix

In Gotenberg 8.17.2 (amd64), a dependency was causing excessive error logs with the Chromium module. The issue has been fixed upstream, and this release includes that fix.

Thanks to @​lindeberg for the heads-up and @​kenshaw for the quick fix!

v8.17.2: 8.17.2

Compare Source

Bug Fixes

• The split feature does not sporadically return corrupt files anymore when using multiple engines. Thanks to @​ninjacarr for the heads-up!
• Warnings from QPDF do not return errors anymore. Thanks to @​zshehov for the fix!

Chore

• Updates Chromium to version 134.0.6998.35 on the amd64 platform.
• Updates Go dependencies.

v8.17.1: 8.17.1

Compare Source

Bug Fix

The split feature wasn't working as expected if more than 9 resulting files. Thanks to @​ninjacarr and @​zach-goldberg for the heads-up!

Chore

Updates Go dependencies.

v8.17.0: 8.17.0

Compare Source

New Features

Configuration with Environment Variables

You can now configure your Gotenberg instances using environment variables. For example, instead of setting --api-port=3000, you can use API_PORT=3000.

Thank you, @​rojomisin, for the suggestion!

Debug Route

When enabled with --api-enable-debug-route (or API_ENABLE_DEBUG_ROUTE=true), the /debug endpoint returns formatted JSON detailing your Gotenberg instance's configuration (including flag values, architecture, etc.).

Thank you, @​nktnet1, for the suggestion!

Bug Fix

Due to a CI misconfiguration, the /version route in Gotenberg 8.16.0 was displaying an empty string. This issue has been fixed. Thanks to @​clee231 for the heads-up!

Chore

• Updates Chromium to version 133.0.6943.53 (except for arm64).
• Updates Go dependencies.

v8.16.0: 8.16.0

Compare Source

New Features

Flattening Annotations

Thanks to @​chakalov, this release brings a new multipart/form-data route for flattening PDFs:

POST /forms/pdfengines/flatten

This feature is also available to the following routes via a new form field flatten (boolean):

• /forms/libreoffice/convert
• /forms/pdfengines/merge
• /forms/pdfengines/split

Chromium Restart Strategy

The new default value for the --chromium-restart-after flag is 10, helping stabilizing the memory usage of your Gotenberg instances.

[!TIP]
Set this value to 0 to reset to the previous behavior.

Thanks @​HarryGogonis, @​michalschroeder and @​Fank for the help! See #​987 for more details.

New Log Field log_type

The logs have now a new field log_type to help differentiating entries (either application or access).

Dummy Root Route

Thanks to @​nktnet1, a new root route (e.g., /) prints a welcome message with a link to the documentation.

Faster CI / Latest Chromium Version for armhf

The releasing of a new Docker image of Gotenberg has been drastically reduced, from approximately 1 hour to less than 5 minutes, thanks to arm64 GitHub runners. This also allows for the latest Chromium version on the armhf variant.

Misc

[!CAUTION]
/version route is now behind the basic authentication if enabled.

Chore

• Updates Chromium to version 132.0.6834.110/160.
• Updates Go dependencies.

v8.15.3: 8.15.3

Compare Source

Fix

Switches from info to debug a logging entry about stuck Chromium processes being killed.

Chore

Updates Go dependencies.

v8.15.2: 8.15.2

Compare Source

New Feature

This release improves the cleanup process for both LibreOffice and Chromium when they are restarted, and makes Chromium’s restart strategy (e.g., --chromium-restart-after) more effective.

Chore

Updates Go dependencies.

---

You may now sponsor this open-source project. Thanks ❤️

v8.15.1: 8.15.1

Compare Source

Fix

The PDF/A and PDF/UA conversion is broken in version 8.15.0 for the Chromium and LibreOffice routes. This release fixes this issue. Thanks @​starwalkn for the heads up!

---

You may now sponsor this open-source project. Thanks ❤️

v8.15.0: 8.15.0

Compare Source

Happy Holidays! 🎅 🎁 🎄

New Features

Split Route

This release brings a new multipart/form-data route for splitting PDF files:

POST /forms/pdfengines/split

It accepts the following form fields:

Key	Description	Default
splitMode	Either intervals or pages.	Required
splitSpan	Either the intervals or the page ranges to extract, depending on the selected mode.	Required
splitUnify	Specify whether to put extracted pages into a single file or as many files as there are page ranges. Only works with pages mode.	false

Thanks @​ps73, @​nodecentral, @​markitosgv, @​wjkoh!

Split Chromium PDFs

The multipart/form-data routes from the Chromium module also accepts the previous form fields for splitting the resulting PDF.

Split LibreOffice PDFs

In the same manner, the multipart/form-data route from the LibreOffice module accepts the previous form fields for splitting the resulting PDFs.

Chore

• Updates Chromium to version 131.0.6778.204/139 (except for armhf).
• Updates Go dependencies.

---

You may now sponsor this open-source project. Thanks ❤️

v8.14.1: 8.14.1

Compare Source

Fix

Keywords metadata (ExifTool PDF Engine)

The Keywords metadata is now correctly handled by ExifTool.

Thanks @​ABAG603 for the heads up!

---

You may now sponsor this open-source project. Thanks ❤️

v8.14.0: 8.14.0

Compare Source

New Feature

Generate Document Outline (Chromium)

The new form field generateDocumentOutline embeds the document outline into the PDF if set to true.

Thanks @​nktnet1 for the contribution!

Chore

Updates Go dependencies.

---

You may now sponsor this open-source project. Thanks ❤️

v8.13.0: 8.13.0

Compare Source

New Features

Select PDF Engines per Feature

You may now select PDF engines for each feature thanks to new flags:

• --pdfengines-merge-engines - Set the PDF engines and their order for the merge feature (default qpdf,pdfcpu,pdftk).
• --pdfengines-convert-engines - Set the PDF engines and their order for the convert feature (default libreoffice-pdfengine).
• --pdfengines-read-metadata-engines - Set the PDF engines and their order for the read metadata feature (default exiftool).
• --pdfengines-write-metadata-engines - Set the PDF engines and their order the write metadata feature (default exiftool).

⚠️ The flag --pdfengines-engines is deprecated.

Fail On Resource HTTP Status Codes (Chromium)

Like failOnHttpStatusCodes, the new failOnResourceHttpStatusCodes form field tells Gotenberg to return a 409 Conflict response if the HTTP status code from at least one resource is not acceptable.

Resource Network Errors (Chromium)

The new form field failOnResourceLoadingFailed tells Gotenberg to return a 409 Conflict if Chromium encounters any of the following network errors while attempting to load a resource:

• net::ERR_CONNECTION_CLOSED
• net::ERR_CONNECTION_RESET
• net::ERR_CONNECTION_REFUSED
• net::ERR_CONNECTION_ABORTED
• net::ERR_CONNECTION_FAILED
• net::ERR_NAME_NOT_RESOLVED
• net::ERR_INTERNET_DISCONNECTED
• net::ERR_ADDRESS_UNREACHABLE
• net::ERR_BLOCKED_BY_CLIENT
• net::ERR_BLOCKED_BY_RESPONSE
• net::ERR_FILE_NOT_FOUND

Chore

• Updates Chromium to version 130.0.6723.91 (except for armhf).
• Updates Go dependencies.

---

You may now sponsor this open-source project. Thanks ❤️

v8.12.0: 8.12.0

Compare Source

New Features

Bind IP

The new flag --api-bind-ip allows to set the IP address the API should bind to for incoming connections, instead of the default 0.0.0.0.

For instance: --api-bind-ip=127.0.0.1.

Thanks @​dani for the suggestion!

Scope Extra HTTP Headers (Chromium)

You can add an optional scope token to a header value to restrict its application using a regular expression.

For instance:

curl \
--request POST http://localhost:3000/forms/chromium/convert/url \
--form url=https://my.url \
--form-string 'extraHttpHeaders={"X-Scoped-Header":"value;scope=https?:\\/\\/([a-zA-Z0-9-]+\\.)*domain\\.com\\/.*"}' \
-o my.pdf

This new scope token is only processed by Gotenberg and is never sent with the header value.

Thanks @​forg002-ctrl and @​OsoianMarcel for the help!

pdfcpu CLI

In earlier versions of Gotenberg, we used the pdfcpu Golang library directly. However, there wasn't a clean way to terminate the process in case of a timeout, which could lead to resource leaks. We now rely on the pdfcpu CLI, allowing us to effectively handle timeouts, resulting in a more stable PDF engine.

Chore

Updates Go dependencies.

---

You may now sponsor this open-source project. Thanks ❤️

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.