Troubleshooting

If you encounter an issue not covered here, please:

1. Check if it's already been reported on the GitHub issues or GitHub discussions.
2. Open a new issue or start a discussion if needed.

---

Chromium

Large PDF File Size

• Webfonts can significantly increase PDF sizes. For custom fonts, refer to the fonts configuration section (Issue #521).
• A bug in Chromium seems to duplicate images (Issue #1077).

Trouble Starting

• Increase the startup timeout (see Chromium module configuration).
• On macOS, consider disabling the Use Virtualization Framework (Issue #792).

Printing Failed (-32000)

• This error may occur when converting large documents. Increasing memory might help, but note that it's a known Chromium bug (Issue #788).
• Also, large headers or footers can cause this error.

Blank PDFs

• For versions after 8.11.0, set the skipNetworkIdleEvent field to false.
• Consider upgrading to latest version to benefit from features like Network Errors or Invalid HTTP Status Codes.

Screenshots Repeated and Clipped

• Set the skipNetworkIdleEvent field to false to resolve this issue (Issue #1065).

Timeouts (503 Service Unavailable)

• Check if your Gotenberg instance is overloaded; add more instances if needed.
• Ensure the target page’s resources are accessible.
• Increase the API timeout (API module configuration).
• Optionally, define a maximum queue size for faster request aborts (Chromium module configuration).

---

LibreOffice

PDF/A-1a

• Starting with version 7.6, LibreOffice no longer supports PDF/A-1a. It previously generated PDF/A-1b files, though some validators misidentified them (LibreOffice commit).

Internal Server Error (500)

• Try increasing Gotenberg’s memory and CPU resources (Issue #465).

Trouble Starting

• Increase the startup timeout (LibreOffice module configuration).
• Debian users should use a current version of the distribution (Issue #794).
• For Synology and Paperless-ngx, consult this configuration comment.

Timeouts (503 Service Unavailable)

• Check if your instance is overloaded; consider increasing instances or resource allocation.
• Increase the API timeout (API module configuration).
• Increase the LibreOffice startup timeout (LibreOffice module configuration).
• Optionally, set a maximum queue size for quicker request aborts (LibreOffice module configuration).