diff --git a/docs/troubleshooting.mdx b/docs/troubleshooting.mdx index 24b0e07..399a7e2 100644 --- a/docs/troubleshooting.mdx +++ b/docs/troubleshooting.mdx @@ -71,6 +71,15 @@ solution is to boost the memory and CPU resources allocated to Gotenberg. For additional details, refer to issue [#465](https://github.com/gotenberg/gotenberg/issues/465). +### Trouble Starting + +Startup failures can happen due to several factors. Here are some known solutions: + +* Increase the start timeout. See the [LibreOffice module configuration](configuration#libreoffice) for guidance. +* For Debian users, it's recommended to use a current version of the distribution. For more information, refer to issue [#794](https://github.com/gotenberg/gotenberg/issues/794). +* Users of Synology and Paperless-ngx should consult [this comment](https://github.com/gotenberg/gotenberg/issues/763#issuecomment-1890472047) +for a proven configuration setup. + ### Dealing with Timeouts {#timeouts-libreoffice} If you are experiencing timeouts (i.e., *503 Service Unavailable*), consider the following steps to resolve your issue: