8.0.0

Gotenberg 8 is now out 🎉

For users of 7.x, the transition to this version should be relatively smooth. Most significant changes were introduced in 7.10.x. This release primarily removes deprecated elements (flags, form fields, etc.) and introduces eagerly anticipated features for Chromium. Read on for detailed information.

Upgrade from v7

If you're upgrading from Gotenberg 7, it's recommended to begin with the latest 7.x version, specifically 7.10.2. Monitor the logs of your Gotenberg instances. Pay attention to warnings at startup and during runtime to identify deprecated features in use that will be unavailable in Gotenberg 8.

Refer to the following lists for deprecated elements:

Deprecated Flags

• --api-read-timeout
• --api-process-timeout
• --api-write-timeout
• --api-webhook-allow-list
• --api-webhook-deny-list
• --api-webhook-error-allow-list
• --api-webhook-error-deny-list
• --api-webhook-max-retry
• --api-webhook-retry-min-wait
• --api-webhook-retry-max-wait
• --api-disable-webhook
• --chromium-user-agent
• --chromium-failed-starts-threshold
• --uno-listener-start-timeout
• --uno-listener-restart-threshold
• --unoconv-disable-listener

Deprecated Form Fields

• userAgent (Chromium)
• pdfFormat
• nativePdfA1aFormat (LibreOffice)
• nativePdfFormat (LibreOffice)
• PDF/A-1a as pdfa value (see https://gotenberg.dev/docs/troubleshooting#pdfa-1a).

Deprecated Metrics

• chromium_active_instances_count
• chromium_failed_starts_count
• unoconv_active_instances_count
• libreoffice_listener_active_instances_count
• unoconv_listener_active_instances_count
• libreoffice_listener_queue_length
• unoconv_listener_queue_length
• pdftk_active_instances_count
• qpdf_active_instances_count

New Chromium Features

• You can capture full-page screenshots using the following three routes, which function similarly to their PDF equivalents:
  • POST /forms/chromium/screenshot/url
  • POST /forms/chromium/screenshot/html
  • POST /forms/chromium/screenshot/markdown
  • The following form fields are available: format ("png", "jpeg" or "webp"), quality (jpeg only, 0 to 100), omitBackground, optimizeForSpeed (optimize image encoding for speed not for resulting size).
  • The following features are also available: wait before rendering, emulated media type, custom HTTP headers, invalid HTTP status codes, console exceptions, performance mode.
• New form field failOnHttpStatusCodes: return a 409 Conflict response if the HTTP status code from the main page is not acceptable - thanks @TheRealPaco & @jmvezic!
• New form field skipNetworkIdleEvent: do not wait for Chromium network to be idle, allowing for faster conversions - thanks @rreynier!
• New flag --chromium-clear-cache: clear Chromium cache between each conversion - thanks @low613!
• New flag --chromium-clear-cookies: clear Chromium cookies between each conversion - thanks @low613!